hikiehikieDeveloper Documentation
Başlangıç

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

  1. Panelde Ayarlar → API Anahtarları sayfasını açın ve Yeni anahtar'ı seçin.
  2. Formu doldurun:
AlanAnlamı
Ad1–60 karakter; anahtarı tanımanız için, örneğin "Muhasebe entegrasyonu"
İzinlerAnahtarı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
  1. 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ı

DurumerrorCodeAnlamı
401API_KEY_MISSINGAuthorization: Bearer başlığı yok
401API_KEY_INVALIDBilinmeyen anahtar ya da gizli değer yenilenmiş
401API_KEY_REVOKEDAnahtar iptal edilmiş
401API_KEY_EXPIREDAnahtarın bitiş tarihi geçmiş
403API_PERMISSION_DENIEDAnahtarın bu ucun istediği izni yok
403STORE_INACTIVEMağ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.

Bu sayfada