API publique

Intégrez RepOtz à vos propres systèmes via une API REST documentée. Disponible sur le plan Agency.

Jetons d’API

Depuis votre espace, vous créez des jetons d’API par compte, avec des scopes :

• analytics:read - lecture des analytics.
• campaigns:manage - gestion des campagnes.
• invitations:trigger - déclenchement d’invitations.

Le jeton est affiché une seule fois à sa création (conservez-le en lieu sûr). Vous pouvez le faire tourner (rotation) ou le révoquer à tout moment.

Surface disponible

• Lecture des analytics du compte.
• Liste des campagnes et de leurs parcours.
• Déclenchement de l’envoi d’une campagne d’invitation.

La documentation OpenAPI est disponible (/api/v2/public/openapi.json). Les appels sont soumis à une limite de débit de 60 requêtes par minute et par jeton (réponse HTTP 429 au-delà).

Webhooks sortants

Les webhooks sortants (notification automatique de vos systèmes à chaque nouvel avis/témoignage) ne sont pas encore disponibles ; c’est une évolution prévue.

Questions fréquentes

Q. Sur quel plan l’API publique est-elle disponible ? R. Sur le plan Agency.

Q. J’ai perdu mon jeton, puis-je le revoir ? R. Non, il n’est affiché qu’à la création. Créez-en un nouveau (ou faites une rotation) et révoquez l’ancien.

Q. Puis-je recevoir des webhooks à chaque nouvel avis ? R. Pas encore ; les webhooks sortants sont une évolution prévue.