Anahtarlar
Her entegrasyon için ayrı anahtar oluşturun; izinlerini, bitiş tarihini ve istek sınırını seçin, sonra yenileyin ya da iptal edin.
Her entegrasyon için ayrı bir anahtar oluşturun. Böylece her entegrasyona yalnızca ihtiyaç duyduğu izinleri verebilir, birini diğerlerine dokunmadan durdurabilirsiniz.
Anahtar oluşturma
- Panelde Ayarlar → API Anahtarları sayfasını açın ve Yeni anahtar'ı seçin.
- Formu doldurun:
| Alan | Anlamı |
|---|---|
| Ad | 1–60 karakter; anahtarı tanımanız için, örneğin "Muhasebe entegrasyonu" |
| İzinler | Anahtarın neler yapabileceği. Bkz. İzinler. İzin seçilmeyen anahtar hiçbir şey yapamaz |
| Bitiş tarihi | İsteğe bağlı. Anahtar bu tarihte çalışmayı bırakır. Süresiz için boş bırakın. Gelecekte olmalı |
| İstek sınırı | Dakikada istek sayısı, 1–200. Yeni anahtarlarda varsayılan 60. Bkz. İstekler ve sınırlar |
- Anahtar göründüğü anda kopyalayın.
Anahtar hks_ ile başlar. Yalnızca bir kez gösterilir. hikie anahtarın
yalnızca özetini (hash) saklar, bu yüzden bir daha gösterilemez; kaybederseniz
anahtarı yenileyin. Sunucunuzun gizli anahtar deposunda saklayın.
Anahtarı yalnızca mağaza sahibi oluşturabilir ya da yenileyebilir. Ekip üyeleri listeyi görebilir ve anahtarları iptal edebilir.
Bir mağaza en fazla 20 etkin anahtara sahip olabilir. İptal edilmiş ve süresi dolmuş anahtarlar sayılmaz.
Anahtarı kullanma
Her isteğin Authorization başlığında gönderin:
curl https://api.hikie.space/v1/store \
-H "Authorization: Bearer hks_..."Paneldeki liste her anahtarın adını, son dört karakterini, izinlerini, bitiş tarihini, istek sınırını ve son kullanımını gösterir; böylece artık kullanılmayan bir anahtarı fark edebilirsiniz.
Anahtarı yenileme
Yenile, aynı anahtara yeni bir gizli değer verir. Eski değer hemen çalışmayı bırakır; ad, izinler, bitiş tarihi ve istek sınırı olduğu gibi kalır. Entegrasyonunuzu hemen yeni değerle güncelleyin.
Anahtarı iptal etme
İptal et, bir anahtarı kalıcı olarak kapatır; bir sonraki isteğinden itibaren geçerli olur. Geri alınamaz; yeniden ihtiyacınız olursa yeni anahtar oluşturun. Sızdığından şüphelendiğiniz her anahtarı iptal edin.
Anahtar hataları
| Durum | errorCode | Anlamı |
|---|---|---|
401 | API_KEY_MISSING | Authorization: Bearer başlığı yok |
401 | API_KEY_INVALID | Bilinmeyen anahtar ya da gizli değer yenilenmiş |
401 | API_KEY_REVOKED | Anahtar iptal edilmiş |
401 | API_KEY_EXPIRED | Anahtarın bitiş tarihi geçmiş |
403 | API_PERMISSION_DENIED | Anahtarın bu ucun istediği izni yok |
403 | STORE_INACTIVE | Mağaza aktif değil |
Tam liste Hatalar sayfasında.
İlk mağaza anahtarı
İzinli anahtarlar gelmeden önce bir mağaza API anahtarı oluşturduysanız çalışmaya devam eder. Yalnızca indirim kodu ve kampanya endpoint'lerini çağırabilir ve Yazılım modülünün lisanslarını doğrulayabilir; başka bir şey yapamaz. Listede eski anahtar olarak görünür. Mağaza API'sinin geri kalanı için yeni bir anahtar oluşturun. Eski anahtarı yenilemek diğer anahtarlarınızı etkilemez.