API Documentatie
Krijg programmatisch toegang tot uw versleutelde gegevens met behulp van onze beveiligde REST API met token-gebaseerde authenticatie.
Hoofdstukken
Aan de Slag
Genereer een API-sleutel in uw accountinstellingen om te beginnen
Om de Hexbon API te gebruiken, moet u een API-sleutel genereren via uw Accountinstellingen → API Instellingen pagina. De API gebruikt een tweestaps authenticatiestroom voor verbeterde beveiliging.
Authenticatiestroom
Vraag een Token Aan
Gebruik uw API-sleutel om een tijdelijk toegangstoken aan te vragen via POST /api/v1/auth
Token Geldigheid
Het token is 60 minuten geldig. Vraag na verloop een nieuw token aan.
Gebruik het Token
Neem het token op in de Authorization: Bearer <token> header voor gegevensbewerkingen.
Snelheidsbeperking
De API is beperkt tot 10 verzoeken per minuut per gebruiker. Het overschrijden van deze limiet resulteert in een 429 Too Many Requests antwoord.
Eindpunten
Authenticeren
https://hexbon.com/api/v1/auth
Genereer een tijdelijk toegangstoken met uw API-sleutel.
Headers
| X-API-Key | Uw API-sleutel (verplicht) |
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
}
Lezen
https://hexbon.com/api/v1/data
Haal uw versleutelde gegevens op. Retourneert de client-versleutelde payload (v1:...).
Headers
| Authorization | Bearer <token> (verplicht) |
curl -X GET "https://hexbon.com/api/v1/data" \ -H "Authorization: Bearer your_token_here"
{
"success": true,
"data": "v1:encrypted_payload_here..."
}
Bijwerken
https://hexbon.com/api/v1/data
Sla uw versleutelde gegevens op. Accepteert een client-versleutelde payload (v1:...) in de body van het verzoek.
Opmerking: Schrijftoegang moet zijn ingeschakeld in uw API Instellingen. Standaard is API-toegang alleen-lezen.
Headers
| Authorization | Bearer <token> (verplicht) |
| Content-Type | application/json (verplicht) |
Verzoekbody
| data | Client-versleutelde payload beginnend met v1: (verplicht) |
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."
}
Antwoordformaat
Alle API-antwoorden worden geretourneerd in JSON-formaat met een boolean veld success dat het resultaat van de operatie aangeeft.
{ "success": true, "data": "..." }
{ "success": false, "message": "Error description" }
Foutcodes
| Code | Beschrijving |
|---|---|
| 401 | Ongeldige of ontbrekende API-sleutel / token verlopen |
| 403 | Schrijftoegang uitgeschakeld (voor POST /data) |
| 422 | Ongeldig payloadformaat of opslaglimiet overschreden |
| 429 | Snelheidslimiet overschreden (10 verzoeken/minuut) |
| 500 | Interne serverfout |
Klaar om te Beginnen?
Genereer uw API-sleutel en begin vandaag nog met integreren met Hexbon.
Ga naar API Instellingen