Autenticazione

Scopri come autenticare le tue richieste API

Formato della Chiave API

Tutte le chiavi API iniziano con il prefisso `sk-` seguito da un identificatore univoco. Mantieni la tua chiave API al sicuro e non esporla mai nel codice client-side.

Effettuare Richieste Autenticate

Includi la tua chiave API nell'intestazione `Authorization` utilizzando il formato Bearer token:

curl https://gateway.bananapro.site/api/v1/account/balances \
  -H "Authorization: Bearer sk-your-api-key"

Migliori Pratiche di Sicurezza

Non esporre mai la tua chiave API nel codice lato client o in repository pubblici
Utilizza le variabili d'ambiente per memorizzare la tua chiave API
Crea chiavi API separate per ambienti diversi (sviluppo, staging, produzione)
Ruota periodicamente le tue chiavi API
Monitora l'utilizzo della tua API per eventuali attività sospette

Gestione degli Errori

Se l'autenticazione fallisce, riceverai una risposta 401 Non Autorizzato:

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}