Appeler un connecteur par API
Utilisez l’endpoint et le contrat propres au connecteur.
Votre code envoie des entrées et traite une réponse structurée.
date2026-09-24slotsVotre parcours, en trois étapes.
- 01
Copiez l’exemple généré
Dans Integrations & Exports, choisissez cURL, JavaScript ou Python. L’exemple correspond à ce connecteur.
- 02
Renseignez params
Respectez les entrées du contrat. Transmettez la clé via l’en-tête x-bridge-secret depuis votre serveur.
- 03
Traitez le résultat
Lisez success, data et error. Conservez la référence d’exécution pour retrouver un problème.
Un point à approfondir ?
Ouvrez uniquement le sujet dont vous avez besoin.
Vue d’ensemble
Deux surfaces publiques, pas une de plus
L’endpoint propre à un connecteur déployé — documenté ici — et l’endpoint MCP d’un Toolset. Tout le reste que vous verrez appelé par le tableau de bord est interne, non versionné, et changera sans préavis. Ne construisez pas dessus.
Il n’y a aucun SDK à installer et aucun parcours OAuth. Une clé dans un en-tête, un corps JSON, une réponse JSON.
La requête
curl -X POST "https://api.example.com/api/v1/bridge/{connectorId}/execute" \
-H "x-bridge-secret: {your-connector-secret}" \
-H "Content-Type: application/json" \
-d '{ "params": { "date": "2026-08-21" } }'L’adresse et la clé exactes sont dans l’onglet Integrations & Exports du connecteur, déjà remplies. Toutes les entrées vont dans params ; un champ placé à la racine est ignoré.
La clé est aussi acceptée dans l’URL. Ne l’y mettez pas.
Cela existe pour les outils sans code incapables de poser un en-tête. Tout ce qui passe dans une URL finit dans l’historique du navigateur, les journaux des proxys et ceux des serveurs.
La réponse
{
"success": true,
"data": { "slots": ["09:00", "10:30"] },
"meta": {
"executionId": "9e600e25-…",
"scriptVersion": 3,
"durationMs": 412,
"timestamp": "2026-08-21T09:12:04.821Z"
},
"needsRepair": false
}{
"success": false,
"data": null,
"error": { "code": "AUTH_ERROR", "message": "the session was refused" },
"meta": { "executionId": "…", "durationMs": 60 },
"needsRepair": false
}L’enveloppe ne change jamais de forme. Branchez sur success. meta.executionId est ce qu’il faut citer au support ; meta.scriptVersion est ce qui rend un ancien résultat explicable.
Les quatre codes d’erreur
| Code | À qui est le problème | Quoi faire |
|---|---|---|
INPUT_ERROR | À l’appelant | Une entrée manque, ou le site refuse la valeur. Le message la nomme. Réessayer à l’identique échoue à l’identique. |
AUTH_ERROR | À la connexion | Le connecteur n’a pas pu agir en tant qu’utilisateur connecté. Vela peut s’en remettre seul ; sinon le titulaire du compte reçoit un e-mail. Jamais un problème de code. |
API_CHANGED | Au site | La cible a changé. C’est ce qui déclenche une réparation automatique. Levé aussi quand la réponse ne correspond plus à la sortie déclarée. |
EXECUTION_ERROR | Passager | Un échec réseau ou un délai dépassé. Espacez et réessayez avant de le considérer comme réel. |
Les limites
| Limite | Valeur | En cas de dépassement |
|---|---|---|
| Par connecteur | 1 requête toutes les 5 secondes, avec une réserve de 3 | 429, avec Retry-After et le nombre de secondes à attendre dans le message |
| Simultanées, par compte | 5 exécutions à la fois | 429. Rien n’est mis en file : l’appel est refusé et doit être refait |
| Exécutions, par mois | Offre payante : 10 000 par connecteur utilisé, sans mutualisation. Essai : 10 000 au total. | Refus à la limite applicable, sauf si le dépassement payant est activé |
Suivre un connecteur lent
Ajouter /stream au même chemin donne des événements au fil des étapes, puis la même enveloppe en événement final. Même clé, mêmes entrées, passées en paramètres d’URL.
Le contrat en OpenAPI
Chaque connecteur publie son propre document OpenAPI, téléchargeable depuis l’onglet Integrations & Exports. C’est lui qui engendre tous les autres exports : il ne peut donc pas décrire un endpoint inexistant. Pointez votre générateur dessus plutôt que de recopier à la main.
Le statut HTTP de chaque échec et ce qu’il est sûr de réessayer.
↗Votre situation ne correspond pas au guide ?
Échanger avec l’équipe ↗