Un token d’API permet à votre propre code de communiquer avec Ocoya. Vous les trouverez sous Settings → API — Settings se trouve dans le menu du compte, l’avatar en haut de la barre latérale.
Cet article explique comment gérer les tokens. Pour savoir comment appeler l’API en pratique — l’URL de base, l’en-tête, les endpoints — consultez la documentation REST API.
Commencez ici. Le menu du compte est l’avatar en haut de la barre latérale — Settings, puis API dans la barre latérale des paramètres.
Settings → API, avec le graphique des requêtes en haut et vos tokens en dessous.
Who can use the API
L’accès à l’API est réservé aux owners and admins d’une marque.
| Your role in a brand | Create tokens | A token reaches the brand |
|---|---|---|
| Owner | Yes | Yes |
| Admin | Yes | Yes |
| Manager | No | No |
| Client | No | No |
Un manager qui a besoin d’un accès API pour une marque doit être promu admin de cette marque par son owner (Settings → Members). Dans l’application, l’option API n’apparaît dans Settings que pour les owners et admins.
Create a token
Sélectionnez Create token et donnez‑lui un nom. Ce nom est uniquement pour vous — il sert à distinguer vos tokens plus tard et à révoquer le bon.
Nommez les tokens d’après l’endroit où ils sont utilisés, pas ce qu’ils font. Zapier, staging server, reporting script vous indiquent ce qui va cesser de fonctionner quand vous le révoquez. API key 2 non.
Copiez le token dès qu’il est créé et stockez‑le dans un endroit sûr. Ocoya n’affiche ensuite que les premiers et derniers caractères.
What a token can reach
Un token vous appartient et donne accès à chaque marque dont vous êtes owner ou admin. Un seul token couvre toutes ces marques, y compris celles dont vous deviendrez admin plus tard. Il n’existe aucun moyen de restreindre un token à une seule marque — la liste des tokens affiche All brands pour chacun.
Les marques auxquelles un token donne accès sont vérifiées à chaque requête, en fonction de votre rôle à ce moment‑là. Si vous êtes retiré d’une marque, ou si vous cessez d’en être admin, vos tokens cessent immédiatement d’y donner accès ; si vous devenez admin d’une marque, ils y donnent accès immédiatement. Un token peut tout faire de ce que l’API permet dans chaque marque à laquelle il accède.
Cela a un impact si vous envisagiez de donner à un développeur côté client un token limité à la marque de ce client. Vous ne pouvez pas. Il pourrait accéder à toutes les marques auxquelles vous avez accès.
Un token fonctionne avec tout ce qui est disponible dans la REST API : posts, campagnes d’IA (les créer, les lister et les lire avec leurs posts), le profil et le score de marque de chaque marque, qu’il peut également mettre à jour, les channels et les workflows.
Revoke a token
Le menu ⋯ de chaque token propose Delete token. La suppression est immédiate et définitive — tout ce qui utilise ce token commence aussitôt à échouer, donc assurez‑vous d’abord de savoir ce qui l’utilise. C’est à cela que servent les noms.
Il n’est pas possible de faire une rotation d’un token sur place. Pour le remplacer : créez le nouveau token, basculez votre intégration dessus, puis supprimez l’ancien.
Watching usage
Le graphique API usage affiche les requêtes authentifiées pour la marque actuelle, sur la dernière heure, la dernière journée ou les 30 derniers jours. C’est le moyen le plus rapide de confirmer qu’une intégration appelle bien Ocoya, ou d’identifier une intégration qui appelle beaucoup plus que prévu.
Ocoya autorise 60 requests per minute par clé et renvoie 429 Too Many Requests au‑delà. Tous les détails, y compris les en‑têtes de limitation de débit, se trouvent dans Rate limits.