​
Dates

Verwende ISO-8601-Datetime-Strings für geplante Veröffentlichungszeiten.

2026-07-01T09:00:00Z

Verwende nach Möglichkeit UTC. Wenn deine App lokale Zeiten erzeugt, wandle sie vor dem Senden der Anfrage in einen zeitzonenbewussten ISO-String um.

​
Pagination

List-Endpunkte können, sofern vom Endpunkt unterstützt, Paginierungsparameter wie page und perPage akzeptieren.

Verwende kleine Seitengrößen für nutzerorientierte Oberflächen und größere Seitengrößen nur für Hintergrundjobs, die langsamere Antworten verkraften können.

​
Media URLs

Medien-URLs für Posts müssen absolute URLs sein, die Ocoya abrufen kann.

https://example.com/image.jpg

Vermeide private URLs, auslaufende URLs mit sehr kurzer Lebensdauer sowie Dateien, für deren Abruf Cookies oder benutzerdefinierte Request-Header nötig sind.

​
Brand-Scoped Requests

Die meisten Veröffentlichungs- und Workflow-Operationen benötigen eine brandId.

Verwende zuerst GET /brands und übergib dann die ausgewählte Brand-ID an Endpunkte wie:

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

​
Social Profile IDs

Verwende GET /social-profiles?brandId=BRAND_ID, um die socialProfileIds zu finden, auf die Posts zielen sollen.

Nutze nur Profile, die mit derselben Brand wie der Post verknüpft sind.