Documentație API
Accesează programatic datele tale criptate folosind API-ul nostru REST securizat cu autentificare bazată pe token.
Capitole
Introducere
Generează o cheie API în setările contului tău pentru a începe
Pentru a utiliza API-ul Hexbon, trebuie să generezi o cheie API din pagina ta Setări Cont → Setări API. API-ul folosește un flux de autentificare în doi pași pentru securitate sporită.
Fluxul de Autentificare
Solicită un Token
Folosește cheia API pentru a solicita un token de acces temporar prin POST /api/v1/auth
Valabilitatea Token-ului
Token-ul este valabil timp de 60 minute. După expirare, solicită un nou token.
Folosește Token-ul
Include token-ul în antetul Authorization: Bearer <token> pentru operațiunile cu date.
Limitarea Ratei
API-ul este limitat la 10 cereri pe minut per utilizator. Depășirea acestei limite va rezulta într-un răspuns 429 Too Many Requests.
Endpoint-uri
Autentificare
https://hexbon.com/api/v1/auth
Generează un token de acces temporar folosind cheia API.
Antete
| X-API-Key | Cheia ta API (obligatoriu) |
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
}
Citire
https://hexbon.com/api/v1/data
Preia datele tale criptate. Returnează payload-ul criptat de client (v1:... sau v2:...).
Antete
| Authorization | Bearer {token} (obligatoriu) |
curl -X GET "https://hexbon.com/api/v1/data" \ -H "Authorization: Bearer your_token_here"
{
"success": true,
"data": "v1:encrypted_payload_here..."
}
Actualizare
https://hexbon.com/api/v1/data
Salvează datele tale criptate. Acceptă un payload criptat de client (v1:... sau v2:...) în corpul cererii.
Notă: Accesul la scriere trebuie activat în Setări API. Implicit, accesul API este doar pentru citire.
Antete
| Authorization | Bearer {token} (obligatoriu) |
| Content-Type | application/json (obligatoriu) |
Corpul Cererii
| data | Payload criptat de client începând cu v1: sau v2: (obligatoriu) |
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."
}
Formatul Răspunsului
Toate răspunsurile API sunt returnate în format JSON cu un câmp boolean success care indică rezultatul operațiunii.
{ "success": true, "data": "..." }
{ "success": false, "message": "Error description" }
Coduri de Eroare
| Cod | Descriere |
|---|---|
| 401 | Cheie API invalidă sau lipsă / token expirat |
| 403 | Accesul la scriere dezactivat (pentru POST /data) |
| 422 | Format de payload invalid sau limită de stocare depășită |
| 429 | Limita de rată depășită (10 cereri/minut) |
| 500 | Eroare internă a serverului |