Skip to main content
API anahtarları, /v1 Public API’ye yapılan istekleri doğrular. Her anahtar bir hizmet hesabına aittir ve o hesabın ayrıntı sayfasından, Developer Hub üzerinden oluşturulur. Bir gizli anahtarın güvenli biçimde saklanması ve döndürülmesi gereksinimlerinizi karşılıyorsa, özel bir arka uç entegrasyonu için kapsamı sınırlandırılmış bir API anahtarı kullanın. OAuth istemcisi veya belirteç değişimi gerekmez. Kuruluşunuz bunun yerine kısa ömürlü OAuth erişim belirteçleri gerektiriyorsa Kimlik Doğrulama bölümüne bakın.

​
Anahtarın yapısı

  • Tanımlayıcı — ak_ ile başlar. Destek kayıtlarında, günlüklerde ve yapılandırmada güvenle referans verilebilir; tek başına hiçbir yetki sağlamaz.
  • Gizli anahtar — lsk_live_ ile başlar. Entegrasyonunuzun sunduğu kimlik bilgisi budur. Oluşturma veya döndürme sırasında yalnızca bir kez gösterilir ve sonradan alınamaz. Anahtar listesinde yalnızca son dört karakter (örneğin lsk_live_…xQc4) gösterilir; böylece bir satırı, çağıranın elindeki kimlik bilgisiyle eşleştirebilirsiniz.
  • İzinleri — anahtarın sahibi olan hizmet hesabının izinlerinin, oluşturma sırasında seçilen bir alt kümesi. Bir anahtar, hesabın izin verdiğinden fazlasını asla yapamaz.
  • Son kullanma tarihi — zorunludur. Her anahtarın bir son kullanma tarihi vardır.
Gizli anahtarları gösterildikleri anda bir gizli anahtar yöneticisinde saklayın. Bunları asla sürüm kontrolüne eklemeyin, istemci tarafı koduna gömmeyin veya sohbette paylaşmayın. Gizli anahtara sahip olan herkes, anahtarın izinleriyle işlem yapabilir.

​
Anahtar oluşturma

Hizmet hesabının ayrıntı sayfasında dört adımda anahtar oluşturursunuz: anahtara ad verin, bu belirli anahtarın ihtiyaç duyduğu izinleri seçin, bir son kullanma süresi belirleyin — 30, 90 veya 365 gün ya da bir yıla kadar özel bir süre — ve gözden geçirin. Gizli anahtar tamamlandığında yalnızca bir kez görüntülenir. Hesap daha fazlasına izin verse bile her anahtarın kapsamını, çağıranın ihtiyaç duyduğu en dar izin kümesiyle sınırlandırın. Bir anahtar sızarsa, etki alanı o anahtarın izinleriyle sınırlı kalır.

​
Kesinti olmadan döndürme

Döndürme, yeni bir gizli anahtar üretir ve 1 saat, 24 saat veya 7 gün süren bir çakışma penceresi başlatır; bu süre boyunca eski gizli anahtar çalışmaya devam eder. Böylece yeni gizli anahtarı dağıtımlarınıza kendi hızınızda uygulayabilirsiniz:
1

Anahtarı döndürün

En yavaş dağıtım yolunuzu kapsayacak bir çakışma penceresi seçin. Yeni gizli anahtar yalnızca bir kez gösterilir; hemen saklayın.
2

Entegrasyonlarınızı güncelleyin

Eski gizli anahtarı yapılandırıldığı her yerde değiştirin. Anahtarın durumu, pencere sona erene kadar çakışma durumunda olarak görünür.
3

Pencere kapanmadan önce doğrulayın

Trafiğin yeni gizli anahtara geçtiğini doğrulamak için istek günlüklerini kullanın. Çakışma sona erdiğinde eski gizli anahtar artık kimlik doğrulamaz.
Anahtarları son kullanma tarihinden önce de döndürün: son kullanma tarihine yaklaşan anahtarlar, anahtar listesinde süresi dolmak üzere olarak işaretlenir. Süresi dolmuş bir anahtar kimlik doğrulamayı durdurur; bu anahtarla yapılan istekler, credential_expired koduyla bir 401 döndürür.

​
Anında iptal

İptal işlemi hemen geçerli olur ve kalıcıdır; çakışma penceresi yoktur ve geri alınamaz. Gizli anahtarının açığa çıktığından şüphelendiğiniz anda anahtarı iptal edin; sağlıklı bir kimlik bilgisini değiştiriyorsanız bunun yerine döndürme işlemini kullanın. İptal edilmiş bir anahtarla yapılan istekler, credential_revoked koduyla bir 401 döndürür. Bir entegrasyonun sahip olduğu tüm anahtarları aynı anda durdurmanız gerekiyorsa, bunun yerine hizmet hesabını devre dışı bırakın.