API Dokümantasyonu
Token tabanlı kimlik doğrulama ile güvenli REST API'mizi kullanarak şifrelenmiş verilerinize programatik olarak erişin.
Bölümler
Başlarken
Başlamak için hesap ayarlarınızda bir API anahtarı oluşturun
Hexbon API'sini kullanmak için Hesap Ayarları → API Ayarları sayfanızdan bir API anahtarı oluşturmanız gerekir. API, gelişmiş güvenlik için iki adımlı bir kimlik doğrulama akışı kullanır.
Kimlik Doğrulama Akışı
Token İste
API anahtarınızı kullanarak POST /api/v1/auth üzerinden geçici bir erişim tokeni isteyin
Token Geçerliliği
Token 60 dakika geçerlidir. Süresi dolduktan sonra yeni bir token isteyin.
Tokeni Kullan
Veri işlemleri için tokeni Authorization: Bearer <token> başlığına ekleyin.
Hız Sınırlaması
API, kullanıcı başına dakikada 10 istek ile sınırlıdır. Bu sınırın aşılması 429 Too Many Requests yanıtı ile sonuçlanacaktır.
Uç Noktalar
Kimlik Doğrulama
https://hexbon.com/api/v1/auth
API anahtarınızı kullanarak geçici bir erişim tokeni oluşturun.
Başlıklar
| X-API-Key | API Anahtarınız (gerekli) |
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
}
Oku
https://hexbon.com/api/v1/data
Şifrelenmiş verilerinizi alın. İstemci tarafından şifrelenmiş yükü (v1:...) döndürür.
Başlıklar
| Authorization | Bearer <token> (gerekli) |
curl -X GET "https://hexbon.com/api/v1/data" \ -H "Authorization: Bearer your_token_here"
{
"success": true,
"data": "v1:encrypted_payload_here..."
}
Güncelle
https://hexbon.com/api/v1/data
Şifrelenmiş verilerinizi kaydedin. İstek gövdesinde istemci tarafından şifrelenmiş yükü (v1:...) kabul eder.
Not: Yazma erişimi API Ayarları sayfanızda etkinleştirilmelidir. Varsayılan olarak API erişimi salt okunurdur.
Başlıklar
| Authorization | Bearer <token> (gerekli) |
| Content-Type | application/json (gerekli) |
İstek Gövdesi
| data | v1: ile başlayan istemci tarafından şifrelenmiş yük (gerekli) |
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."
}
Yanıt Formatı
Tüm API yanıtları, işlemin sonucunu belirten bir success boolean alanı ile JSON formatında döndürülür.
{ "success": true, "data": "..." }
{ "success": false, "message": "Error description" }
Hata Kodları
| Kod | Açıklama |
|---|---|
| 401 | Geçersiz veya eksik API anahtarı / token süresi dolmuş |
| 403 | Yazma erişimi devre dışı (POST /data için) |
| 422 | Geçersiz yük formatı veya depolama sınırı aşıldı |
| 429 | Hız sınırı aşıldı (10 istek/dakika) |
| 500 | Dahili sunucu hatası |
Başlamaya Hazır mısınız?
API anahtarınızı oluşturun ve bugün Hexbon ile entegrasyona başlayın.
API Ayarlarına Git