​
Dates

Usa cadenas de fecha y hora en formato ISO 8601 para las horas de publicación programada.

2026-07-01T09:00:00Z

Utiliza UTC siempre que sea posible. Si generas horas locales en tu app, conviértelas a una cadena ISO con zona horaria antes de enviar la solicitud.

​
Pagination

Los endpoints de listado pueden aceptar parámetros de paginación como page y perPage cuando el endpoint los admita.

Usa tamaños de página pequeños para interfaces de cara al usuario y tamaños de página más grandes solo para procesos en segundo plano que puedan tolerar respuestas más lentas.

​
Media URLs

Las URLs de los recursos multimedia de una publicación deben ser URLs absolutas que Ocoya pueda obtener.

https://example.com/image.jpg

Evita URLs privadas, URLs que expiren muy rápido y archivos que requieran cookies o cabeceras de solicitud personalizadas.

​
Brand-Scoped Requests

La mayoría de operaciones de publicación y workflows necesitan un brandId.

Usa primero GET /brands y luego pasa el ID de la brand seleccionada a endpoints como:

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

​
Social Profile IDs

Usa GET /social-profiles?brandId=BRAND_ID para encontrar los socialProfileIds a los que deben dirigirse las publicaciones.

Utiliza solo perfiles conectados a la misma brand que la publicación.