​
Dates

Naudokite ISO 8601 datos ir laiko eilutes suplanuotų įrašų laikams.

2026-07-01T09:00:00Z

Kiek įmanoma, naudokite UTC. Jei savo programoje generuojate vietinį laiką, prieš siųsdami užklausą konvertuokite jį į laiko juostos atžvilgiu tikslų ISO formato stringą.

​
Pagination

Sąrašus grąžinantys endpoint’ai gali priimti puslapiavimo parametrus, tokius kaip page ir perPage, jei juos palaiko tas endpoint’as.

Naudokite mažus puslapių dydžius sąsajoms, kurias mato naudotojai, ir didesnius puslapių dydžius tik foninėms užduotims, kurios gali toleruoti lėtesnius atsakymus.

​
Media URLs

Įrašų medijos URL adresai turi būti absoliutūs URL, kuriuos Ocoya gali pasiekti.

https://example.com/image.jpg

Venkite privačių URL, labai trumpai galiojančių URL ir failų, kuriems reikia slapukų ar pasirinktinių užklausos antraščių.

​
Brand-Scoped Requests

Daugumai publikavimo ir darbo eigos operacijų reikia brandId.

Pirmiausia naudokite GET /brands, tada perduokite pasirinktą brand ID į tokius endpoint’us kaip:

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

​
Social Profile IDs

Naudokite GET /social-profiles?brandId=BRAND_ID, kad rastumėte socialProfileIds, į kuriuos turėtų būti nukreipti įrašai.

Naudokite tik tuos profilius, kurie prijungti prie tos pačios brand kaip ir įrašas.