Documentazione API
Accedi programmaticamente ai tuoi dati crittografati utilizzando la nostra API REST sicura con autenticazione basata su token.
Capitoli
Per Iniziare
Genera una chiave API nelle impostazioni del tuo account per iniziare
Per utilizzare l'API di Hexbon, devi generare una chiave API dalla tua pagina Impostazioni Account → Impostazioni API. L'API utilizza un flusso di autenticazione a due passaggi per una maggiore sicurezza.
Flusso di Autenticazione
Richiedi un Token
Usa la tua chiave API per richiedere un token di accesso temporaneo tramite POST /api/v1/auth
Validità del Token
Il token è valido per 60 minuti. Dopo la scadenza, richiedi un nuovo token.
Usa il Token
Includi il token nell'intestazione Authorization: Bearer <token> per le operazioni sui dati.
Limitazione della Velocità
L'API è limitata a 10 richieste al minuto per utente. Superare questo limite comporterà una risposta 429 Too Many Requests.
Endpoint
Autenticazione
https://hexbon.com/api/v1/auth
Genera un token di accesso temporaneo utilizzando la tua chiave API.
Intestazioni
| X-API-Key | La tua chiave API (richiesto) |
curl -X POST "https://hexbon.com/api/v1/auth" \ -H "X-API-Key: your_api_key_here"
{
"success": true,
"bearer_token": "abc123def456...",
"expires_at": "2025-11-27T15:30:00Z",
"expires_in": 3600
}
Lettura
https://hexbon.com/api/v1/data
Recupera i tuoi dati crittografati. Restituisce il payload crittografato dal client (v1:...).
Intestazioni
| Authorization | Bearer <token> (richiesto) |
curl -X GET "https://hexbon.com/api/v1/data" \ -H "Authorization: Bearer your_token_here"
{
"success": true,
"data": "v1:encrypted_payload_here..."
}
Aggiornamento
https://hexbon.com/api/v1/data
Salva i tuoi dati crittografati. Accetta un payload crittografato dal client (v1:...) nel corpo della richiesta.
Nota: L'accesso in scrittura deve essere abilitato nelle tue Impostazioni API. Per impostazione predefinita, l'accesso API è di sola lettura.
Intestazioni
| Authorization | Bearer <token> (richiesto) |
| Content-Type | application/json (richiesto) |
Corpo della Richiesta
| data | Payload crittografato dal client che inizia con v1: (richiesto) |
curl -X POST "https://hexbon.com/api/v1/data" \
-H "Authorization: Bearer your_token_here" \
-H "Content-Type: application/json" \
-d '{"data": "v2:your_encrypted_payload"}'
{
"success": true,
"message": "Encrypted data saved successfully."
}
Formato di Risposta
Tutte le risposte API sono restituite in formato JSON con un campo booleano success che indica il risultato dell'operazione.
{ "success": true, "data": "..." }
{ "success": false, "message": "Error description" }
Codici di Errore
| Codice | Descrizione |
|---|---|
| 401 | Chiave API non valida o mancante / token scaduto |
| 403 | Accesso in scrittura disabilitato (per POST /data) |
| 422 | Formato payload non valido o limite di archiviazione superato |
| 429 | Limite di velocità superato (10 richieste/minuto) |
| 500 | Errore interno del server |
Pronto per Iniziare?
Genera la tua chiave API e inizia a integrare con Hexbon oggi.
Vai alle Impostazioni API