Posts
Listar posts de todos os clientes pela API
GET /merchants/posts devolve os posts de todos os seus clientes de uma vez, mais recentes primeiro, usando só o token do merchant. É a visão de monitoramento: onde há posts com falha, o que foi publicado e para qual cliente.
A chamada
GET /api/merchants/posts?status=failed&per_page=50 Authorization: Bearer <merchant token>
O que dá para fazer
- Listar os posts de todos os customers em uma chamada, sem x-customer-token.
- Filtrar por um customer com customer, ou por uma conexão com customer_integration.
- Filtrar por status (created, publishing, published, failed) para achar falhas.
- Achar um post pelo id do seu sistema com external_reference.
- Paginar com per_page, de 1 a 100.
Regras e limites
- Só o Bearer do merchant, sem x-customer-token. Para os posts de um único cliente, use GET /posts com o x-customer-token.
- customer e customer_integration são filtros, não credencial: o cliente e a conexão são conferidos contra o merchant do Bearer.
- Os filtros se combinam. A lista vem com os mais recentes primeiro, 15 por página por padrão.
- Cada post traz customer_uuid, para você saber de qual cliente ele é.
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| customer | string | Não | Filtro: o uuid de um customer do merchant. |
| customer_integration | string | Não | Filtro: o uuid de uma conexão de um customer do merchant. |
| status | string | Não | Filtro: created, publishing, published ou failed. |
| external_reference | string | Não | Filtro: o id do post no seu sistema (até 100 caracteres). |
| per_page | integer | Não | Itens por página, de 1 a 100. Padrão 15. |
| customer_uuid | string | Não | Em cada post da resposta: o customer dono do post. |
Para quem
Painel de operações
O time de suporte vê todos os posts com falha de todos os clientes numa tela, sem consultar cliente por cliente.
Alertas de falha
Um job periódico lista status failed e avisa o responsável de cada conta.
Agente de IA de monitoramento
O agente resume a semana de publicações por cliente e destaca os que mais falharam.
Funciona com
Instagram Business
Facebook
Threads
LinkedIn
Pinterest
YouTube
Perguntas frequentes
Preciso do x-customer-token?
Não. Esta rota usa só o Bearer do merchant. O GET /posts, por cliente, exige o x-customer-token.
Como vejo só um cliente?
Passe customer com o uuid do customer, ou customer_integration com o uuid da conexão.
Como acho os posts com falha?
Filtre por status=failed. Para os detalhes do erro, consulte o post com GET /posts/{uuid}.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
