Inicio rápido de API

Esta guía te llevará de cero a tu primera solicitud exitosa: crear un token personal, conocer la dirección base y llamar a un endpoint REST.

Paso 1. Crear un token personal

Abre el panel personal, la sección de tokens personales, y crea un nuevo token (PAT). Copia su valor de inmediato — se muestra una sola vez y empieza con el prefijo mbp_. Al crearlo, elige las áreas de acceso (scopes) suficientes para tu tarea; más detalles en la guía de autorización.

Paso 2. Dirección base y formato

Todos los endpoints REST están bajo el prefijo /api. No hay versionado en la ruta. Los cuerpos de solicitudes y respuestas son JSON; transmite el encabezado Content-Type: application/json para solicitudes con cuerpo. El token se transmite con el encabezado Authorization: Bearer mbp_….

Paso 3. Primera solicitud — lista de bots

Verifica el token con una solicitud a la lista de tus bots. Para esto se necesita el scope bots:read (o *):

curl -H "Authorization: Bearer mbp_TU_TOKEN" https://tu-dominio/api/bots

La respuesta será un array JSON de bots. Si el token es incorrecto o ha expirado — se devolverá 401 con el cuerpo {"error":"..."} (ver errores).

Paso 4. Primera mutación — crear una reacción

Crear una reacción requiere el scope reactions:write. Sustituye el identificador del bot del paso 3:

curl -X POST -H "Authorization: Bearer mbp_TU_TOKEN" -H "Content-Type: application/json" -d '{"name":"Hola","trigger":{"type":"command","value":"/start"}}' https://tu-dominio/api/bots/BOT_ID/reactions

Una respuesta exitosa devolverá la reacción creada con su id. Consulta los campos exactos del cuerpo en la referencia interactiva — genera ejemplos listos en curl, JavaScript y Python para cada endpoint.

Paso 5. A continuación — por la referencia

Cuando el token funcione, lo demás es más cómodo de explorar en la referencia interactiva: allí se ve la lista completa de endpoints, los scopes requeridos, los esquemas de cuerpos y el botón «Try it».

Qué sigue