Kimlik doğrulama
API'ye yapılan her istek bir API anahtarı taşır. İstekler hiçbir zaman bir tarayıcı oturumuyla eşleştirilmez.
API anahtarı oluşturma
Hesabınızda API anahtarları bölümünden en fazla 5 anahtar oluşturun. Oturumunuz açıkken bir anahtarı o sayfadan istediğiniz zaman kopyalayabilirsiniz: onu şifrelenmiş olarak saklarız ve yalnızca size gösteririz. Onu bir parola gibi gizli tutun; görülmüş olabilirse iptal edip yeni bir anahtar oluşturun.
API anahtarını gönderme
Anahtarı Authorization başlığında Bearer ve ardından anahtarın kendisi olarak gönderin. X-API-Key de çalışır.
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"Bir API anahtarı neler yapabilir
Yeni bir API anahtarı her şeyi yapabilir: bakiyenizi, denetleyicileri, siparişlerinizi ve sonuçlarını görebilir ve listenizi saklayan veya bakiyenizi harcayan POST /uploads, POST /estimates ve POST /orders çağrılarını kullanabilir. 8 Kasım 2026'dan önce oluşturulmuş bir anahtar salt okunur olabilir: her şeyi görebilir, ancak bu üç çağrı onu missing_scope ile reddeder.
Geçerlilik süresi ve IP adresleri
Yeni bir API anahtarının süresi hiç dolmaz ve her adresten çalışır. 8 Kasım 2026'dan önce oluşturulmuş bir anahtarın bir son kullanma tarihi olabilir; bu tarihten sonra expired_key ile reddedilir. Ya da sunucunuzun IP adresleriyle sınırlanmış olabilir; bu durumda başka bir yerden gelen istek ip_not_allowed ile reddedilir. Bunlardan birini değiştirmek için yeni bir anahtar oluşturun ve eskisini iptal edin.
API anahtarını güvende tutma
- API anahtarına parola gibi davranın: anahtara sahip olan herkes bakiyenizi harcayabilir.
- Yalnızca sunucunuzda kullanın. API, bir web sayfasından yapılan çağrılara izin vermez.
- Kodunuzda ve sürüm denetiminizde bulundurmayın.
- Bir anahtar görülmüş olabilirse hesabınızda hemen iptal edin. Anında çalışmayı durdurur. Daha önce verilen siparişler çalışmaya devam eder.
- Yalnızca API'ye gönderin. Yükleme ve indirme bağlantıları kendi izinlerini taşır, bu yüzden API anahtarınızı bu bağlantılara göndermeyin.
Bir API anahtarı reddedildiğinde
Yanlış, iptal edilmiş veya süresi dolmuş bir anahtar 401 yanıtı alır. Engellenmiş bir anahtar veya hesap 403 yanıtı alır. Bkz. Hatalar.