Démarrage rapide de l’API
Lire la liste de vos bots et créer une réaction depuis un programme. Premier appel, jeton et exemples curl.
Sur cette page
L’API permet à votre programme d’agir dans GetMyBot : lire les bots, créer des réactions ou obtenir des données. Cet exemple s’adresse à la personne qui développe une intégration. Pour configurer un bot sans programmation, utilisez le constructeur visuel.
Créez d’abord une clé d’accès, le jeton personnel. Envoyez ensuite une requête HTTP à l’adresse de l’opération, appelée endpoint. Les commandes curl ci-dessous s’exécutent dans un terminal. Remplacez https://votre-domaine par l’adresse de votre installation GetMyBot.
Étape 1 : créer un jeton personnel
Dans votre compte, ouvrez les jetons personnels et créez un PAT. Copiez-le immédiatement : il ne s’affiche qu’une fois et commence par mbp_. Choisissez à la création les portées (scopes), les droits nécessaires aux seules opérations prévues. Voir le guide d’authentification.
Étape 2 : adresse de base et format
Tous les endpoints REST commencent par /api. Le chemin n’indique pas de version. Les corps des requêtes et réponses sont en JSON ; pour une requête avec corps, ajoutez Content-Type: application/json. Le jeton se transmet avec Authorization: Bearer <JETON_PERSONNEL> : remplacez le texte et les chevrons par le jeton complet, préfixe mbp_ inclus. Ne rajoutez pas le préfixe.
Étape 3 : première requête, liste des bots
Vérifiez le jeton en demandant vos bots. Il faut la portée bots:read ou * :
curl -H "Authorization: Bearer <JETON_PERSONNEL>" https://votre-domaine/api/bots
La réponse est un tableau JSON de bots. Si le jeton est incorrect ou expiré, vous recevrez 401 avec {"error":"..."}. Voir Erreurs.
Étape 4 : première modification, créer une réaction
Une modification est une requête qui change les données. Cet exemple crée une réaction dans un bot choisi : exécutez-le dans un projet où elle est utile.
Créer une réaction exige reactions:write. Remplacez BOT_ID par l’ID obtenu à l’étape 3 :
curl -X POST https://votre-domaine/api/bots/BOT_ID/reactions \
-H "Authorization: Bearer <JETON_PERSONNEL>" \
-H "Content-Type: application/json" \
-d '{"name":"Bienvenue","trigger":{"type":"command","value":"/start"}}'
La réponse réussie contient la réaction créée et son id. Les champs exacts du corps figurent dans la référence interactive, qui propose des exemples curl, JavaScript et Python pour chaque endpoint.
Étape 5 : poursuivre avec la référence
Une fois le jeton vérifié, consultez la référence interactive : elle liste les routes, les portées, les champs de requête et un bouton Try it pour faire un essai.
Première requête Managed AI
Créez un PAT avec managed_ai:invoke. Idempotency-Key distingue les opérations : gardez la même clé et le même corps pour réessayer une requête, prenez une nouvelle clé pour une autre opération.
curl -X POST https://votre-domaine/api/v1/ai/responses \
-H "Authorization: Bearer <JETON_PERSONNEL>" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ai-demo-0001" \
-d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Résume brièvement la conversation"}]}],"max_output_tokens":300}'
Si votre intégration expose Managed AI ou Meta, interrogez d’abord /api/public/capabilities. La réponse précise si la fonction est activée dans cette installation. Une fonction désactivée n’est pas une panne réseau : masquez-la ou indiquez son indisponibilité.
Pour aller plus loin
- Authentification et jetons : PAT, en-tête et portées.
- Erreurs : format et codes de réponse.
- Pagination : parcourir de longues listes.