Utiliser le Workbench développeurs
Le Workbench est la console des personnes qui intègrent Cord à un autre système. Il se trouve dans l’application : vous contrôlez votre intégration sans quitter votre espace de travail.
L’ouvrir
- Activez le Mode développeur dans Votre compte › Préférences. C’est une préférence de votre compte, et non de l’organisation.
- La pastille Développeurs apparaît dans le coin inférieur droit. Cliquez dessus ou appuyez sur la touche
W.
Vous devez disposer du droit Paramètres dans l’organisation. Sans lui, le Workbench n’apparaît pas.
Le contenu de chaque onglet
- Vue d’ensemble : requêtes, taux d’erreur, latence, envois de webhooks, utilisation de l’API du mois et alertes actives.
- Journaux : chaque requête envoyée à l’API et au serveur MCP. Recherchez par chemin, par request id (
req_…) ou par code d’erreur, et ouvrez-en une pour voir son détail, la copier en cURL ou la rejouer dans le Shell. - Erreurs : les erreurs regroupées par code et par chemin, avec leur nombre d’occurrences et la façon de les résoudre.
- Événements : ce qui s’est passé dans votre compte (un devis payé, un client créé) et ce que Cord a envoyé à chaque endpoint, avec la possibilité de renvoyer.
- Webhooks : vos endpoints, leur taux de réussite et l’historique des envois, avec ce que Cord a envoyé et ce que votre serveur a répondu.
- Shell : testez n’importe quelle opération de l’API avec votre session, sans créer de clé. En Test, il peut créer et modifier des données dans votre environnement de test ; en Production, il se limite à la lecture. Il vous fournit le code prêt à l’emploi en cURL, Node, JavaScript ou Python.
- Clés API : créez, renouvelez et révoquez des clés API, et consultez les connexions autorisées : Zapier, Make, le module complémentaire Gmail et toute application connectée via OAuth.
- Santé : la liste de ce qui peut casser votre intégration, comme un endpoint qui échoue souvent ou une clé sur le point d’expirer.
Dans la barre supérieure, l’Inspecteur (touche /) recherche n’importe quel req_…, evt_… ou l’ID d’un devis, d’une facture, d’un client, d’un produit, d’une clé ou d’un webhook.
Ce que Cord conserve et pendant combien de temps
Pour chaque requête envoyée à l’API, Cord conserve ses données techniques : méthode, chemin, statut, latence, adresse IP, la clé qui l’a effectuée, le request id, le code et le message d’erreur, la version, l’origine et l’Idempotency-Key. Il ne conserve jamais le corps de la requête ni de la réponse, afin de ne pas stocker les données de vos clients.
Les journaux sont conservés 30 jours. Si vous avez besoin d’un historique plus long, enregistrez dans votre système le request id que renvoie chaque réponse dans l’en-tête Cord-Request-Id.
Questions fréquentes
Le Workbench ou le Shell consomment-ils mon quota d’API ? Non. Seules les requêtes effectuées avec des clés live sont décomptées.
Je ne vois pas une requête que j’ai effectuée avec une clé de test. Le Workbench affiche l’environnement dans lequel se trouve l’application. Passez dans l’environnement de test pour voir ce qu’ont fait vos clés sk_test_.
Pourquoi ne vois-je pas l’historique des envois d’un webhook ? L’historique, les nouvelles tentatives et les renvois font partie de l’offre Professionnel ou supérieure.
Le guide complet se trouve dans la documentation du Workbench.