​
Dates

Utilisez des chaînes de date-heure ISO 8601 pour les heures de publication planifiée.

2026-07-01T09:00:00Z

Utilisez le fuseau UTC lorsque c’est possible. Si vous générez des heures locales dans votre application, convertissez-les en chaîne ISO avec fuseau horaire avant d’envoyer la requête.

​
Pagination

Les endpoints de liste peuvent accepter des paramètres de pagination comme page et perPage lorsqu’ils sont pris en charge par l’endpoint.

Utilisez de petites tailles de page pour les interfaces visibles par les utilisateurs, et des tailles de page plus grandes uniquement pour les tâches d’arrière-plan qui peuvent tolérer des réponses plus lentes.

​
Media URLs

Les URLs des médias d’un post doivent être des URLs absolues qu’Ocoya peut récupérer.

https://example.com/image.jpg

Évitez les URLs privées, les URLs expirant très rapidement et les fichiers qui nécessitent des cookies ou des en-têtes de requête personnalisés.

​
Brand-Scoped Requests

La plupart des opérations de publication et de workflow nécessitent un brandId.

Utilisez d’abord GET /brands, puis passez l’ID de la marque sélectionnée aux endpoints tels que :

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

​
Social Profile IDs

Utilisez GET /social-profiles?brandId=BRAND_ID pour trouver les socialProfileIds que les posts doivent cibler.

N’utilisez que des profils connectés à la même marque que le post.