GetQR API’si beta aşamasındadır ve seçili çalışma alanlarında kullanılabilir. Ayrıntılar genel sürümden önce değişebilir.
Başlamadan önce
- Çalışma alanı sahibi veya Editor olmanız gerekir. Viewer rolündekiler API anahtarı oluşturamaz ve kullanamaz.
- Çalışma alanı sahibinin aktif bir aboneliği olmalıdır.
API anahtarınızı oluşturun
1
Hesap ayarlarınızı açın
Hesap ayarlarınızı açın ve API bölümüne gidin.
2
Anahtarı oluşturun
Generate API key öğesine tıklayın.
3
Anahtarı kopyalayın
Anahtarı görüntüleyin ve kopyalayın. Anahtarlar
sk_live_ ile başlar.Kimliği doğrulanmış istekler gönderin
Anahtarı her isteğinAuthorization başlığında Bearer token olarak gönderin:
Anahtar olmadan çalışan tek uç nokta durum kontrolüdür.
Erişim ve roller
- Roller. Yalnızca çalışma alanı sahibi ve Editor rolündekiler API anahtarı oluşturup kullanabilir. Viewer rolündekiler kullanamaz.
- Çalışma alanı. Her anahtar tek bir çalışma alanına aittir ve her istek o çalışma alanında çalışır. Çalışma alanı kimliği göndermeniz gerekmez.
- Anlık kontroller. Erişim her istekte mevcut rolünüze ve çalışma alanı sahibinin aboneliğine göre kontrol edilir. Kendi aboneliğiniz dikkate alınmaz. Rolünüz Viewer olarak değişirse veya sahibin aboneliği sona ererse, erişim geri gelene kadar istekler
403döndürür. Yeni bir anahtara ihtiyacınız yoktur. - Kaldırılma. Çalışma alanından kaldırılırsanız API anahtarınız silinir. Yeniden eklenirseniz yeni bir anahtar oluşturun.
Anahtarınızı yeniden oluşturun
Anahtar sızarsa veya erişmemesi gereken biri ona ulaşırsa anahtarı yeniden oluşturun.1
Regenerate'e tıklayın
Hesap ayarlarınızda API bölümüne gidin ve Regenerate öğesine tıklayın.
2
Onaylayın
Regenerate key öğesine tıklayın.
3
Uygulamalarınızı güncelleyin
Yeni anahtarı kopyalayın ve eski anahtarı kullandığınız her yerde değiştirin.
Anahtarınızı güvende tutun
Anahtara bir parola gibi davranın: anahtara sahip olan herkes çalışma alanınızda QR kodları oluşturabilir, değiştirebilir ve silebilir.- Anahtarı kaynak kodunda değil, bir ortam değişkeninde veya gizli bilgi yöneticisinde saklayın.
- API’yi yalnızca sunucunuzdan çağırın. Anahtarı asla bir web sitesine, mobil uygulamaya veya kullanıcıların inceleyebileceği başka bir yere koymayın.
- Anahtarı yalnızca ihtiyacı olan geliştiricilerle paylaşın.
- Sızdığından şüphelendiğiniz anda anahtarı yeniden oluşturun.
Sık karşılaşılan sorunlar
Daha önce çalışan bir anahtarla 401 alıyorum
Daha önce çalışan bir anahtarla 401 alıyorum
Anahtar yeniden oluşturulmuş ya da çalışma alanından kaldırıldığınız için anahtar silinmiştir. Güncel anahtarı hesap ayarlarınızdan kopyalayın veya yeni bir anahtar oluşturun.
Her istekte 403 alıyorum
Her istekte 403 alıyorum
Rolünüzün sahip veya Editor olduğunu ve çalışma alanı sahibinin aboneliğinin aktif olduğunu kontrol edin. Erişim geri geldiği anda anahtar yeniden çalışır.
404 "This endpoint is not available." alıyorum
404 "This endpoint is not available." alıyorum
API beta aşamasındadır ve çalışma alanınız için henüz etkinleştirilmemiştir.
API ayarlarını göremiyorum
API ayarlarını göremiyorum
Bu ayarlar yalnızca çalışma alanı sahibine ve Editor rolündekilere, yalnızca API’nin etkin olduğu çalışma alanlarında görünür.