API REST de OLAB Assist

Ce que vous obtenez

• Des endpoints pour le compte, les sites, le détail d’un site, les contrôles, les réponses IA, l’historique des scores et les changements.
• Les sites peuvent être désignés par leur id ou leur domaine, par ex. /sites/yourbrand.example.
• Pagination avec next_cursor, 120 requêtes par minute et par clé.
• Un contrat versionné : dans la v1, des champs sont seulement ajoutés, jamais supprimés ni renommés.

Avant de commencer

• Un compte OLAB Assist avec l’offre Agency, connecté en tant que propriétaire du compte.
• Un outil capable d’envoyer des requêtes HTTP avec un en-tête (curl, Postman, votre CRM, un script).

Configurer étape par étape

1. 1

   Créer une clé

   Intégrations → Clés d’API : donnez-lui le nom de l’outil (par ex. « Synchro HubSpot ») et cliquez sur Créer une clé. Copiez-la tout de suite : elle n’est affichée qu’une seule fois.

2. 2

   Faire votre première requête

   Envoyez la clé dans l’en-tête Authorization. L’exemple ci-dessous liste vos sites avec leurs derniers scores.

3. 3

   Choisir les données utiles

   Utilisez /sites/{site} pour une vue complète, /findings pour les problèmes, /answers pour les réponses IA et /history pour l’évolution des scores. La référence complète se trouve dans la documentation développeurs.

4. 4

   Le planifier

   Lancez votre import une fois par jour ou après chaque webhook scan.completed, pour ne jamais interroger l’API plus que nécessaire.

curl https://api.olabassist.com/api/v1/sites \
  -H "Authorization: Bearer olab_YOUR_KEY"

Tips

• Une clé par intégration : la révoquer n’affecte que cet outil.
• Ignorez les champs que vous ne connaissez pas. De nouveaux champs sont ajoutés au fil du temps et votre code continue de fonctionner.
• Pour Google Sheets, un Apps Script avec UrlFetchApp et un déclencheur quotidien suffit.

Troubleshooting

Questions