​
Dates

Używaj dat i godzin w formacie ISO 8601 dla zaplanowanych czasów publikacji postów.

2026-07-01T09:00:00Z

Korzystaj z czasu UTC, kiedy to możliwe. Jeśli w swojej aplikacji generujesz czas lokalny, przekonwertuj go na uwzględniający strefę czasową ciąg ISO przed wysłaniem żądania.

​
Pagination

Endpointy listujące mogą przyjmować parametry paginacji, takie jak page i perPage, jeśli są obsługiwane przez dany endpoint.

Używaj małych rozmiarów stron dla interfejsów widocznych dla użytkownika i większych rozmiarów stron tylko dla zadań w tle, które mogą tolerować wolniejsze odpowiedzi.

​
Media URLs

Adresy URL mediów w postach muszą być bezwzględnymi adresami URL, które Ocoya może pobrać.

https://example.com/image.jpg

Unikaj prywatnych adresów URL, adresów z bardzo krótką datą wygaśnięcia oraz plików, które wymagają ciasteczek lub niestandardowych nagłówków żądań.

​
Brand-Scoped Requests

Większość operacji publikowania i workflow wymaga brandId.

Najpierw użyj GET /brands, a następnie przekaż wybrany ID brandu do takich endpointów jak:

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

​
Social Profile IDs

Użyj GET /social-profiles?brandId=BRAND_ID, aby znaleźć socialProfileIds, które posty powinny targetować.

Korzystaj tylko z profili połączonych z tym samym brandem co post.