​
Dates

Usa stringhe datetime in formato ISO 8601 per gli orari di pubblicazione programmata dei post.

2026-07-01T09:00:00Z

Usa il fuso orario UTC quando possibile. Se generi orari locali nella tua app, convertili in una stringa ISO con fuso orario prima di inviare la richiesta.

​
Pagination

Gli endpoint di listing possono accettare parametri di paginazione come page e perPage quando supportati dall’endpoint.

Usa dimensioni di pagina ridotte per le interfacce rivolte all’utente e dimensioni di pagina più grandi solo per i job in background che possono tollerare risposte più lente.

​
Media URLs

Gli URL dei media dei post devono essere URL assoluti che Ocoya possa recuperare.

https://example.com/image.jpg

Evita URL privati, URL a scadenza con una durata molto breve e file che richiedono cookie o header di richiesta personalizzati.

​
Brand-Scoped Requests

La maggior parte delle operazioni di pubblicazione e workflow richiede un brandId.

Usa prima GET /brands, poi passa l’ID del brand selezionato a endpoint come:

  • 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 per trovare i socialProfileIds a cui i post devono essere indirizzati.

Usa solo profili collegati allo stesso brand del post.