​
Dates

Use strings de data/hora ISO 8601 para tempos de publicação agendada.

2026-07-01T09:00:00Z

Use UTC sempre que possível. Se você gerar horas locais na sua aplicação, converta-as para uma string ISO com fuso horário antes de enviar o pedido.

​
Pagination

Os endpoints de listagem podem aceitar parâmetros de paginação como page e perPage quando o endpoint os suportar.

Use tamanhos de página pequenos para interfaces visíveis ao utilizador e tamanhos de página maiores apenas para tarefas em segundo plano que possam tolerar respostas mais lentas.

​
Media URLs

Os URLs de media dos posts devem ser URLs absolutos que a Ocoya consiga obter.

https://example.com/image.jpg

Evite URLs privados, URLs que expiram com tempos de vida muito curtos e ficheiros que exijam cookies ou cabeçalhos de pedido personalizados.

​
Brand-Scoped Requests

A maioria das operações de publicação e de workflow precisam de um brandId.

Use primeiro GET /brands e depois passe o ID da brand selecionada para endpoints como:

  • GET /social-profiles
  • GET /hashtag-libraries
  • GET /post
  • POST /post
  • POST /post/ai
  • POST /campaigns
  • GET /workflow

​
Social Profile IDs

Use GET /social-profiles?brandId=BRAND_ID para encontrar os socialProfileIds que os posts devem direcionar.

Use apenas perfis ligados à mesma brand que o post.