API Anahtarı ile Erişim

Bu sayfa API isteklerinin nasıl yetkilendirildiğini anlatır. Yetkilendirme kurumunuza verilen API anahtarıyla yapılır.

Bu, kişi kimliği doğrulaması değildir. API anahtarı sunucunuzu tanıtır, bir personeli değil. Panel kullanıcılarının girişi ayrı bir konudur ve Panel Kılavuzu sayfasında anlatılır.

Anahtar nedir ve nereden alınır

API anahtarı, kurumunuzun hesabına bağlı gizli bir dizgidir. Her API isteğinde bu anahtarı gönderirsiniz. LydiaGate anahtardan hangi hesabın istek yaptığını anlar.

Anahtarı panelden üretirsiniz: Geliştirici → API Anahtarları. Bu ekran “API anahtarı yönetimi” yetkisi ister. Anahtar tam haliyle yalnız üretildiği anda gösterilir. Sonra listede yalnız son karakterleri görünür. Anahtarı kaybederseniz geri alamazsınız. Yeni bir anahtar üretirsiniz.

Test ve canlı hesabın anahtarları ayrıdır. Test anahtarı canlı ortamda çalışmaz. Canlı anahtar test ortamında çalışmaz.

Anahtar biçimi

Anahtar, üretildiği ortamı gösteren bir önekle başlar.

Önek	Ortam
ldg_test_…	Test
ldg_live_…	Canlı

Her istekte Authorization başlığı

Anahtarı Authorization başlığında Bearer şemasıyla gönderirsiniz:

Authorization: Bearer ldg_test_…

Dikkat

Başlık değeri tam olarak Bearer, tek boşluk ve anahtardan oluşur. Başında ya da sonunda boşluk ya da satır sonu bulunan bir başlık geçersiz sayılır ve istek 401 alır. Başlığın iki kez gönderilmesi de 401 verir. Çoğu HTTP kütüphanesi değeri kendisi kırpar. Bu sorun daha çok başlığı elle kuran kabuk betiklerinde görülür. Anahtarınız geçerliyken 401 alıyorsanız ilk bakılacak yer burasıdır.

Anahtarı saklama kuralları

• Anahtarı yalnız sunucunuzda saklayın. Gizli ayar deposu ya da ortam değişkeni kullanın.
• Anahtarı tarayıcıya, mobil uygulamaya ya da kod deposuna koymayın.
• Anahtarı loglara yazmayın.
• Anahtarı yalnız sunucudan sunucuya çağrılarda kullanın.
• Anahtarın sızdığından şüphelenirseniz hemen yeni anahtar üretin ve eskisini iptal edin.

Anahtar iptali

Anahtarı panelden iptal edersiniz: Geliştirici → API Anahtarları. İptal anında geçerlidir ve geri alınamaz. İptal edilen anahtarla yapılan her istek 401 alır.

Kesintisiz geçiş için sırayı şöyle kurun:

1. Yeni anahtarı üretin.
2. Yeni anahtarı sunucunuza yazın.
3. Sunucunuzun yeni anahtarla çalıştığını doğrulayın.
4. Eski anahtarı iptal edin.

Yetkisiz istek yanıtı

Geçersiz, eksik ya da iptal edilmiş anahtarla yapılan istek 401 Unauthorized ile reddedilir. Yanıt gövdesi standart hata biçimindedir. Authorization başlığı yoksa kod unauthorized, anahtar geçersiz ya da iptal edilmişse kod invalid_token olur. Ayrıntı için Hata Kodları sayfasına bakın.

Hesap durumunun etkisi

Hesabınız askıdaysa sorgular çalışır. Yeni ödeme ve iade istekleri 403 ve partner_not_active koduyla reddedilir. Hesabınız kapalıysa sorgular dahil her istek 403 ve partner_not_active alır. Hesap yeniden açıldığında aynı anahtar kendiliğinden çalışır. Yeni anahtar üretmeniz gerekmez.