API Dokumentacija
Pristupite programski vašim šifriranim podacima koristeći naš sigurni REST API s autentifikacijom temeljenom na tokenima.
Poglavlja
Početak
Generirajte API ključ u postavkama vašeg računa za početak
Za korištenje Hexbon API-ja, morate generirati API ključ na vašoj Postavke Računa → API Postavke stranici. API koristi dvostupanjski tijek autentifikacije za poboljšanu sigurnost.
Tijek Autentifikacije
Zatražite Token
Koristite vaš API ključ za traženje privremenog pristupnog tokena putem POST /api/v1/auth
Valjanost Tokena
Token vrijedi 60 minuta. Nakon isteka, zatražite novi token.
Koristite Token
Uključite token u Authorization: Bearer <token> zaglavlje za operacije s podacima.
Ograničenje Brzine
API je ograničen na 10 zahtjeva po minuti po korisniku. Prekoračenje ovog ograničenja rezultirat će odgovorom 429 Too Many Requests.
Krajnje Točke
Autentifikacija
https://hexbon.com/api/v1/auth
Generirajte privremeni pristupni token koristeći vaš API ključ.
Zaglavlja
| X-API-Key | Vaš API ključ (obavezno) |
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
}
Čitanje
https://hexbon.com/api/v1/data
Dohvatite vaše šifrirane podatke. Vraća klijentski šifrirani teret (v1:...).
Zaglavlja
| Authorization | Bearer <token> (obavezno) |
curl -X GET "https://hexbon.com/api/v1/data" \ -H "Authorization: Bearer your_token_here"
{
"success": true,
"data": "v1:encrypted_payload_here..."
}
Ažuriranje
https://hexbon.com/api/v1/data
Spremite vaše šifrirane podatke. Prihvaća klijentski šifrirani teret (v1:...) u tijelu zahtjeva.
Napomena: Pristup pisanju mora biti omogućen u vašim API Postavke. Prema zadanim postavkama, API pristup je samo za čitanje.
Zaglavlja
| Authorization | Bearer <token> (obavezno) |
| Content-Type | application/json (obavezno) |
Tijelo Zahtjeva
| data | Klijentski šifrirani teret koji počinje s v1: (obavezno) |
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."
}
Format Odgovora
Svi API odgovori vraćaju se u JSON formatu s boolean poljem success koje označava rezultat operacije.
{ "success": true, "data": "..." }
{ "success": false, "message": "Error description" }
Kodovi Grešaka
| Kod | Opis |
|---|---|
| 401 | Nevažeći ili nedostajući API ključ / token istekao |
| 403 | Pristup pisanju onemogućen (za POST /data) |
| 422 | Nevažeći format tereta ili prekoračeno ograničenje pohrane |
| 429 | Prekoračeno ograničenje brzine (10 zahtjeva/minuta) |
| 500 | Interna greška poslužitelja |
Spremni za početak?
Generirajte vaš API ključ i započnite integraciju s Hexbonom danas.
Idi na API Postavke