Démarrage rapide API

Ce guide vous mène de zéro à votre première requête réussie : créer un jeton personnel, connaître l'adresse de base et appeler un endpoint REST.

Étape 1. Créer un jeton personnel

Ouvrez l'espace personnel, section des jetons personnels, et créez un nouveau jeton (PAT). Copiez sa valeur immédiatement — elle n'est affichée qu'une seule fois et commence par le préfixe mbp_. Lors de la création, sélectionnez les portées (scopes) suffisantes pour votre besoin ; plus de détails dans le guide d'autorisation.

Étape 2. Adresse de base et format

Tous les endpoints REST sont sous le préfixe /api. Il n'y a pas de versionnement dans le chemin. Les corps de requêtes et de réponses sont en JSON ; transmettez l'en-tête Content-Type: application/json pour les requêtes avec corps. Le jeton est transmis via l'en-tête Authorization: Bearer mbp_….

Étape 3. Première requête — liste des bots

Vérifiez le jeton en demandant la liste de vos bots. Cela nécessite la portée bots:read (ou *) :

curl -H "Authorization: Bearer mbp_VOTRE_JETON" https://votre-domaine/api/bots

La réponse sera un tableau JSON de bots. Si le jeton est invalide ou expiré, une réponse 401 avec un corps {"error":"..."} est renvoyée (voir erreurs).

Étape 4. Première mutation — créer une réaction

La création d'une réaction nécessite la portée reactions:write. Remplacez l'identifiant du bot par celui obtenu à l'étape 3 :

curl -X POST -H "Authorization: Bearer mbp_VOTRE_JETON" -H "Content-Type: application/json" -d '{"name":"Bonjour","trigger":{"type":"command","value":"/start"}}' https://votre-domaine/api/bots/BOT_ID/reactions

Une réponse réussie renvoie la réaction créée avec son id. Les champs exacts du corps sont disponibles dans la référence interactive — elle génère des exemples prêts à l'emploi en curl, JavaScript et Python pour chaque endpoint.

Étape 5. La suite — via la référence

Une fois le jeton fonctionnel, la suite est plus commode à explorer dans la référence interactive : liste complète des endpoints, scopes requis, schémas de corps et bouton « Try it ».

Pour aller plus loin