Avvio rapido API
Ottieni la lista dei bot e crea una reazione via API: primo accesso, token personale ed esempi curl.
In questa pagina
L'API consente al tuo programma di operare in GetMyBot: leggere l'elenco dei bot, creare reazioni o ottenere dati. Questa guida è per chi sviluppa un'integrazione. Per la configurazione ordinaria del bot usa il costruttore visuale.
Per iniziare, crea una chiave d'accesso, il token personale. Poi invia una richiesta HTTP all'indirizzo dell'operazione, detto endpoint. Gli esempi usano curl nel terminale. Sostituisci https://tuo-dominio con l'indirizzo della tua installazione GetMyBot.
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 mbp_. Scegli gli ambiti di accesso (scopes), cioè solo i permessi necessari. Per i dettagli vedi la guida all'autorizzazione.
Passo 2. Indirizzo base e formato
Tutti gli endpoint REST sono sotto /api, senza versione nel percorso. Richieste e risposte usano JSON; per richieste con corpo passa Content-Type: application/json. Il token va nell'intestazione Authorization: Bearer <TOKEN_PERSONALE>: sostituisci l'intero segnaposto, comprese le parentesi angolari, con il token completo di mbp_. Non aggiungere il prefisso una seconda volta.
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 <TOKEN_PERSONALE>" 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 modifica: creare una reazione
Una modifica è una richiesta che cambia i dati. Questo esempio crea una reazione nel bot scelto: eseguilo in un progetto in cui ti serve davvero quella reazione.
La creazione richiede lo scope reactions:write. Inserisci l'ID del bot ottenuto al passo 3:
curl -X POST https://tuo-dominio/api/bots/BOT_ID/reactions \
-H "Authorization: Bearer <TOKEN_PERSONALE>" \
-H "Content-Type: application/json" \
-d '{"name":"Ciao","trigger":{"type":"command","value":"/start"}}'
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, consulta il riferimento interattivo per gli altri endpoint, gli ambiti di accesso, i campi delle richieste e il pulsante Try it per provarli.
Prima richiesta Managed AI
Crea un PAT con lo scope managed_ai:invoke. Idempotency-Key distingue un'operazione dall'altra: quando ripeti la stessa richiesta, mantieni invariati chiave e corpo; per una nuova operazione usa una chiave nuova.
curl -X POST https://tuo-dominio/api/v1/ai/responses \
-H "Authorization: Bearer <TOKEN_PERSONALE>" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ai-demo-0001" \
-d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Riassumi brevemente la conversazione"}]}],"max_output_tokens":300}'
Se la tua integrazione mostra le funzioni Managed AI o Meta, interroga prima /api/public/capabilities. La risposta indica se la funzione è attiva in questa installazione. Una funzione disattivata non è un errore di rete: nascondila o mostra che non è disponibile.
Passo successivo
- Autorizzazione e token — PAT, intestazione e scopes in dettaglio.
- Errori — formato e codici di stato.
- Paginazione — come scorrere liste lunghe.