Vai al contenuto
PuraPura Developers

SDK in abbonamento

OAuth per utente · limiti del piano condivisi tra le app · modello gestito da Pura.

Cerchi le API a consumo?
Developers/Bottone Connect

Bottone Connect

Collegamento nel browser, stato per scheda e callback protetta.

Integra il bottone pubblico

createConnectButton genera il bottone e avvia un flusso PKCE con stato salvato per scheda. Il browser torna sul callback nella stessa scheda. Il client secret non deve mai essere presente in queste opzioni.

typescript
import {createConnectButton, completeBrowserConnection} from '@pura-ai/sdk';

const options = {
  apiBase: 'https://ai.puradigital.it/v1',
  clientId: 'YOUR_PUBLIC_CLIENT_ID',
  redirectUri: 'https://your-app.example/pura/callback',
};
document.querySelector('#pura-connect')!.append(
  createConnectButton({...options, locale: 'it', onError: showError})
);
// On the callback page, in the same tab:
const tokens = await completeBrowserConnection(options);
await userTokenStore.set(tokens);

Bottone in un SaaS confidential

Il bottone della tua UI può aprire un endpoint del tuo backend che genera createAuthorization. Conserva il pending nella sessione backend, esegui lo scambio sul server e torna a una pagina della tua app. Non usare completeBrowserConnection per trasmettere un client secret dal browser.

Gestione del ritorno

Gli helper verificano state, callback e validità temporale prima dello scambio. Mostra un errore comprensibile e un nuovo bottone se il flusso è negato o scaduto. Evita analytics e log che registrino l’intero URL contenente il codice.

Disconnetti una sola app

L’utente può revocare il collegamento nella console Pura. La revoca rende inutilizzabili i token di quell’app; le altre app collegate continuano a funzionare. Cancella anche la sessione OAuth locale quando l’utente richiede la disconnessione nella tua app.