Autorizzazione
Updated:
L’API x402 non prevede account, password o chiavi API. Al loro posto vengono utilizzati tre tipi di autenticazione: la firma di pagamento, il token di accesso dell’ordine e la firma del portafoglio.
Non fornire i tuoi token di accesso a terzi e non inviare mai la chiave privata del tuo portafoglio a nessuno, noi compresi.
Caratteristiche principali
Firma di pagamento
Il portafoglio che effettua il pagamento è l’acquirente. Il primo pagamento andato a buon fine crea automaticamente un account del portafoglio, non è necessario registrarsi. I rinnovi e il traffico residenziale di un ordine possono essere pagati solo dal portafoglio che ha pagato l’ordine.
Token di accesso
Ogni ordine a pagamento genera un access_token una volta, nel 202 risposta. Inviarla nel Authorization intestazione per ogni richiesta relativa a questo ordine: stato e credenziali, rinnovo, traffico, impostazioni, sostituzione dell’IP ed eventi.
Firma del portafoglio
Per ottenere nuovi token per i tuoi ordini o per prelevare il tuo saldo, firma un messaggio di testo una tantum (EIP-4361) con lo stesso wallet. La firma non comporta alcun trasferimento di fondi.
Token di accesso
Authorization: Bearer x402_q8Zt3Lw0mN6pR2vY9cK4hJ7sD1fG5bX8aE3uW0iO2nTProprietà | Valore |
|---|---|
Formato |
|
Dove | Solo nel |
Ambito | Un ordine: |
Emissione | Una volta per operazione, nel |
Durata | Fino alla data di scadenza dell’ordine più 90 giorni; i rinnovi ne prolungano la validità. Per un’operazione senza data di scadenza, 90 giorni dopo il suo stato finale |
Revoca | Blocco del portafoglio, |
I nuovi token non annullano quelli precedenti: ogni token valido di un ordine continua a funzionare.
Errori
Risposta | Quando |
|---|---|
| Il |
| Qualsiasi altro problema: l’ordine non esiste, il token appartiene a un altro ordine, il token è stato revocato o è scaduto. L’API non distingue questi casi |
Esempio
401: Accesso non autorizzato
{
"error": "unauthorized",
"message": "Authorization is required",
"retryable": false,
"retry_action": "abandon",
"detail": "Authorization: Bearer <access_token> from the order response is required"
}Gettone smarrito
Se perdi il token, recupera l'accesso tramite il tuo portafoglio: Recupera l'accesso. La risposta elenca tutti gli ordini del portafoglio con i nuovi token.