Pular para o conteúdo
Entrar Lista de espera

Listar posts

GET /v1/posts escopo read

Lista os posts, do mais recente para o mais antigo (na fila e nos rascunhos, do mais próximo para o mais distante). Filtros: state, channel, tag.

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Parâmetros

Nome Onde Descrição
state consulta Filtra pelo estado. Valores: queued, draft, sent, error, canceled.
channel consulta Id do canal ou nome da rede.
tag consulta Nome de uma etiqueta.
limit consulta Itens por página (1 a 200). Padrão: 50.
offset consulta Quantos pular. Padrão: 0.

Exemplo

curl "https://praeko.app/v1/posts" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "total": 1,
  "posts": [
    {
      "id": "01KA3W2Y6H1RC5ZQ8M0T4VXE7N",
      "title": "O teste que só falhava na segunda (versão final)",
      "state": "queued",
      "type": "short",
      "kind": "video",
      "origin": "api",
      "media": {
        "video": "01KA3VQ7M2T9XE4HB8N5RZ6C0D",
        "cover": null
      },
      "texts": {
        "youtube": {
          "title": "O teste que só falhava na segunda",
          "text": "Um teste que passava de terça a domingo. O que ele escondia.\n\n#programação #testes"
        }
      },
      "tags": [
        "bastidores",
        "testes"
      ],
      "thumb": null,
      "items": [
        {
          "id": "01KA3W2Y6J9D3BNF7G2K5PQS8A",
          "network": "youtube",
          "channel": "01KA3V0R5D8M2WQ7X4HT9NZ1BF",
          "state": "scheduled",
          "scheduledFor": "2026-11-10T20:30:00.000Z",
          "custom": true,
          "mode": "scheduled",
          "runAt": "2026-11-10T19:30:00.000Z",
          "thumb": null
        }
      ],
      "createdAt": "2026-11-07T14:02:11.482Z",
      "updatedAt": "2026-11-07T15:40:03.120Z"
    }
  ]
}

Cada post vem sem actions (elas só aparecem em GET /v1/posts/:id). Filtros: state, channel, tag.

Erros

Sem erros específicos desta rota além dos comuns.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.