Pura per gli sviluppatori

Come funziona#

L’utente collega il proprio account Pura alla tua applicazione e approva gli scope richiesti. La tua applicazione riceve token OAuth con cui può inviare richieste e leggere il consumo autorizzato. Pura applica i servizi e i limiti dell’abbonamento dell’utente.

Ogni applicazione ha un collegamento separato. Tutte le app autorizzate dello stesso account condividono i limiti del piano; l’utente può revocare una singola app senza scollegare le altre.

Scegli il percorso di integrazione#

Per un SaaS con backend, registra un’app confidential e gestisci scambio e conservazione dei token sul server. Per un client pubblico, usa il bottone Connect con PKCE e nessun client secret. In entrambi i casi l’utente autorizza una specifica app.

La modalità abbonamento usa gli endpoint di inferenza delegata. Le API key e il wallet pay-as-you-go appartengono a un percorso distinto, documentato nella guida gateway di Pura Docs.

Contratto e disponibilità#

Questo manuale descrive gli SDK 0.1.1 e il contratto API e webhook 2026-10-01. Usa la distribuzione ufficiale fornita da Pura e consulta Versioni e compatibilità prima di aggiornare una dipendenza.

Chiama capabilities() dopo il collegamento per verificare quali servizi sono disponibili all’utente. Abilita nella tua UI solo le funzioni disponibili e gestisci un servizio non disponibile con un messaggio chiaro. Per le richieste in abbonamento non devi scegliere un modello.

Indice del manuale#

Inizia dal quickstart e dalla registrazione dell’app. Approfondisci OAuth e storage dei token prima di implementare chat o audio. Usa il riferimento API per i campi delle richieste e la guida webhook per ricevere gli aggiornamenti di stato.