Documentation API
Accédez par programmation à vos données chiffrées à l'aide de notre API REST sécurisée avec authentification par jeton.
Chapitres
Commencer
Générez une clé API dans les paramètres de votre compte pour commencer
Pour utiliser l'API Hexbon, vous devez générer une clé API depuis votre page Paramètres du Compte → Paramètres API. L'API utilise un flux d'authentification en deux étapes pour une sécurité renforcée.
Flux d'Authentification
Demander un Jeton
Utilisez votre clé API pour demander un jeton d'accès temporaire via POST /api/v1/auth
Validité du Jeton
Le jeton est valide pendant 60 minutes. Après expiration, demandez un nouveau jeton.
Utiliser le Jeton
Incluez le jeton dans l'en-tête Authorization: Bearer <token> pour les opérations de données.
Limitation de Débit
L'API est limitée à 10 requêtes par minute par utilisateur. Le dépassement de cette limite entraînera une réponse 429 Too Many Requests.
Points de Terminaison
Authentifier
https://hexbon.com/api/v1/auth
Générez un jeton d'accès temporaire à l'aide de votre clé API.
En-têtes
| X-API-Key | Votre clé API (requis) |
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
}
Lire
https://hexbon.com/api/v1/data
Récupérez vos données chiffrées. Renvoie la charge utile chiffrée par le client (v1:...).
En-têtes
| Authorization | Bearer <token> (requis) |
curl -X GET "https://hexbon.com/api/v1/data" \ -H "Authorization: Bearer your_token_here"
{
"success": true,
"data": "v1:encrypted_payload_here..."
}
Mettre à jour
https://hexbon.com/api/v1/data
Enregistrez vos données chiffrées. Accepte une charge utile chiffrée par le client (v1:...) dans le corps de la requête.
Note : L'accès en écriture doit être activé dans vos Paramètres API. Par défaut, l'accès API est en lecture seule.
En-têtes
| Authorization | Bearer <token> (requis) |
| Content-Type | application/json (requis) |
Corps de la Requête
| data | Charge utile chiffrée par le client commençant par v1: (requis) |
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 de Réponse
Toutes les réponses de l'API sont renvoyées au format JSON avec un champ booléen success indiquant le résultat de l'opération.
{ "success": true, "data": "..." }
{ "success": false, "message": "Error description" }
Codes d'Erreur
| Code | Description |
|---|---|
| 401 | Clé API invalide ou manquante / jeton expiré |
| 403 | Accès en écriture désactivé (pour POST /data) |
| 422 | Format de charge utile invalide ou limite de stockage dépassée |
| 429 | Limite de débit dépassée (10 requêtes/minute) |
| 500 | Erreur interne du serveur |
Prêt à Commencer ?
Générez votre clé API et commencez à intégrer Hexbon dès aujourd'hui.
Aller aux Paramètres API