Avvio rapido API

Questa guida ti porta da zero alla prima richiesta riuscita: creare un token personale, conoscere l'indirizzo base e chiamare un endpoint REST.

Passo 1. Creare un token personale

Apri l'area personale, sezione token personali, e crea un nuovo token (PAT). Copialo subito — viene mostrato una sola volta e inizia con il prefisso mbp_. Al momento della creazione scegli gli ambiti (scopes) sufficienti per il tuo scopo; maggiori dettagli nella guida all'autorizzazione.

Passo 2. Indirizzo base e formato

Tutti gli endpoint REST vivono sotto il prefisso /api. Non c'è versioning nel percorso. I corpi di richieste e risposte sono JSON; passa l'intestazione Content-Type: application/json per le richieste con corpo. Il token va passato con l'intestazione Authorization: Bearer mbp_….

Passo 3. Prima richiesta — lista dei bot

Verifica il token con una richiesta alla lista dei tuoi bot. Per questo è necessario lo scope bots:read (o *):

curl -H "Authorization: Bearer mbp_IL_TUO_TOKEN" https://tuo-dominio/api/bots

La risposta sarà un array JSON di bot. Se il token è errato o scaduto, verrà restituito 401 con il corpo {"error":"..."} (vedi errori).

Passo 4. Prima mutazione — creare una reazione

La creazione di una reazione richiede lo scope reactions:write. Sostituisci l'identificatore del bot ottenuto al passo 3:

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

La risposta di successo restituirà la reazione creata con il suo id. I campi esatti del corpo si trovano nel riferimento interattivo — genera esempi pronti su curl, JavaScript e Python per ogni endpoint.

Passo 5. Proseguire con il riferimento

Quando il token funziona, il resto è più comodo da esplorare nel riferimento interattivo: lì puoi vedere l'elenco completo degli endpoint, gli scopes richiesti, gli schemi dei corpi e il pulsante «Try it».

Passo successivo