Kimlik doğrulama

Her istek bir API anahtarıyla imzalanır. Oturum, çerez veya yenileme jetonu yoktur.

Anahtarı gönderme

Authorization: Bearer eyk_live_<64 hex karakter>

Başlık eksikse 401 missing_authorization, biçim hatalıysa 401 invalid_authorization döner.

Anahtar biçimi

• eyk_live_ öneki + 64 onaltılık karakter
• Toplam 73 karakter
• Önek (eyk_live_ab12cd34) panelde görünür; hangi anahtar olduğunu ayırt etmeye yarar, tek başına yetkilendirmez

Anahtar nasıl saklanır

Anahtarın kendisi veritabanımızda tutulmaz. Yalnızca SHA-256 özeti saklanır. Bu yüzden kaybedilen anahtar geri gösterilemez; yenisini üretip eskisini iptal edin.

Anahtarı istemci tarafına (tarayıcı, mobil uygulama) koymayın. Anahtar sunucunuzda kalmalıdır; ele geçiren kişi sizin adınıza gönderi oluşturabilir.

Anahtar yönetimi

• Aynı anda en fazla 10 aktif anahtar tutabilirsiniz
• Anahtarı panelden iptal edebilirsiniz; iptal anında geçersizleşir
• İptal edilmiş anahtar 401 key_revoked döner
• Hesabınız askıya alınırsa tüm anahtarlar 403 account_suspended döner

Yetki kapsamı

Anahtar, onu üreten hesabın kendi verisine erişir. Başka bir müşterinin siparişini okumak veya iptal etmek mümkün değildir; böyle bir istek 404 order_not_found döner.

Hata kodlarının tamamı için Hata kodları sayfasına bakın.