Ein API-Token lässt deinen eigenen Code mit Ocoya sprechen. Du findest sie unter Settings → API — Settings ist im Account-Menü, dem Avatar oben in der Seitenleiste.
Auf dieser Seite geht es darum, Tokens zu verwalten. Wie du die API tatsächlich aufrufst — die Basis-URL, den Header, die Endpunkte — steht in der REST API documentation.
Hier startest du. Das Account-Menü ist der Avatar oben in der Seitenleiste — Settings, dann API in der Settings-Seitenleiste.
Settings → API, oben das Request-Diagramm und unten deine Tokens.
Who can use the API
API-Zugriff ist nur für owners and admins einer Brand.
| Your role in a brand | Create tokens | A token reaches the brand |
|---|---|---|
| Owner | Yes | Yes |
| Admin | Yes | Yes |
| Manager | No | No |
| Client | No | No |
Ein Manager, der API-Zugriff für eine Brand braucht, muss vom Owner dieser Brand zum Admin gemacht werden (Settings → Members). In der App wird die API-Option in Settings nur für Owners und Admins angezeigt.
Create a token
Wähle Create token und gib ihm einen Namen. Der Name ist nur für dich — er ist dazu da, damit du Tokens später auseinanderhalten und das richtige aufheben kannst.
Benenne Tokens danach, wo sie benutzt werden, nicht danach, was sie tun. Zapier, staging server, reporting script sagt dir, was ausfällt, wenn du es aufhebst. API key 2 nicht.
Kopiere das Token direkt nach dem Erstellen und bewahre es an einem sicheren Ort auf. Ocoya zeigt danach nur noch die ersten und letzten paar Zeichen an.
What a token can reach
A token is yours, and reaches every brand you own or are an admin of. Ein Token deckt alle ab, einschließlich Brands, bei denen du später zum Admin gemacht wirst. Es gibt keine Möglichkeit, ein Token auf eine einzelne Brand zu beschränken — in der Token-Liste steht bei jedem All brands.
Welche Brands ein Token erreicht, wird bei jeder Anfrage geprüft, basierend auf deiner Rolle in diesem Moment. Wenn du aus einer Brand entfernt wirst oder kein Admin mehr bist, erreichen deine Tokens sie sofort nicht mehr; wenn du zum Admin einer Brand gemacht wirst, erreichen sie sie sofort. Ein Token kann alles tun, was die API anbietet, in jeder Brand, die es erreicht.
Das ist wichtig, wenn du vorhattest, dem Developer eines Kunden ein Token nur für dessen Brand zu geben. Das geht nicht. Sie könnten jede Brand erreichen, auf die du Zugriff hast.
Ein Token funktioniert mit allem in der REST API: Posts, AI-Kampagnen (erstellen, auflisten und mit ihren Posts auslesen), das Profil und den Brand Score jeder Brand, die es auch aktualisieren kann, Channels und Workflows.
Revoke a token
Im ⋯-Menü bei jedem Token findest du Delete token. Das Löschen ist sofort und dauerhaft — alles, was dieses Token benutzt, schlägt direkt fehl. Stelle also sicher, dass du weißt, was es verwendet. Dafür sind die Namen da.
Es gibt keine Möglichkeit, ein Token direkt zu rotieren. Um eines zu ersetzen: Erstelle das neue Token, zieh deine Integration um, und lösche dann das alte.
Watching usage
Das API usage-Diagramm zeigt authentifizierte Anfragen für die aktuelle Brand, über die letzte Stunde, den letzten Tag oder die letzten 30 Tage. Es ist der schnellste Weg zu prüfen, ob eine Integration Ocoya tatsächlich aufruft oder ob sie deutlich mehr Aufrufe macht als erwartet.
Ocoya erlaubt 60 requests per minute pro Key und gibt darüber hinaus 429 Too Many Requests zurück. Alle Details, einschließlich der Rate-Limit-Header, findest du unter Rate limits.