API ve yapay zeka asistanları/Kimlik doğrulama ve API anahtarları

Kimlik doğrulama ve API anahtarları

API anahtarınızı nasıl gönderirsiniz, kaç anahtara sahip olabilirsiniz, bir anahtar neyi yapabilir ve neyi yapamaz, bir anahtar sızdığında ne yaparsınız ve bir yapay zeka asistanının bağlantısını nasıl kesersiniz.

Anahtarı Authorization başlığında gönderin

Authorization: Bearer YOUR_API_KEY

API'nin bir anahtarı okuduğu tek yer bu başlıktır.

  • Bir anahtarı asla URL'ye koymayın (?api_key=…). URL'ler günlüklere, tarayıcı geçmişine ve paylaşılan bağlantılara düşer. API böyle bir isteği 400 api_key_in_query ile reddeder. O anahtarı açığa çıkmış sayın: iptal edin ve yeni bir anahtar oluşturun.
  • Tam olarak https://gloriads.com/api/v1 adresini çağırın: başka bir adrese yönlendirmeyi izleyen bir istemci, anahtarınızı yolda düşürür.
  • API'yi bir elektronik tablodan, bir betikten veya bir sunucudan çağırın, bir web sayfasının kodundan değil: sayfayı ziyaret eden herkes anahtarı okuyabilir.

Bir anahtar neler yapabilir

  • Her uç noktada hesabınızı okur.
  • Hiçbir şeyi değiştirmez. API salt okunurdur.
  • Hesabınızın sınırlarını paylaşır: tüm anahtarlarınız ve bağlı yapay zeka asistanlarınız birlikte sayılır; bu yüzden ikinci bir anahtar size daha fazla istek hakkı vermez. Bkz. Sınırlar ve hatalar.

Anahtar oluşturma

Ayarlar → API → Anahtar oluştur.

  • Ad en fazla 40 karakter olabilir. Daha sonra hangi anahtarı iptal edeceğinizi bilmek için aracın adını kullanın.
  • Anahtar bir kez gösterilir. Yalnızca parmak izini saklarız; bu yüzden onu kimse yeniden gösteremez, biz bile. Bir parola yöneticisinde ya da aracınızın gizli ayarlarında saklayın.
  • Aynı anda 10 anahtara sahip olabilirsiniz.
  • Herkese açık demo hesabı anahtar oluşturamaz.

Anahtar listesi

Her anahtar adını, ilk karakterlerini (key_live_ab12…), ne zaman oluşturulduğunu ve en son ne zaman kullanıldığını gösterir.

“Son kullanım” en fazla saatte bir güncellenir; bu yüzden birkaç dakika önce kullanılan bir anahtar hâlâ daha eski bir saat gösterebilir.

Anahtarı iptal etme

Anahtarın ⋯ menüsünü açın, ardından İptal et seçeneğini seçin.

İptal hemen geçerli olur: o anahtarla yapılan bir sonraki istek, hiç var olmamış bir anahtarla aynı yanıtı, yani 401 unauthorized yanıtını alır. İptal edilen bir anahtar geri getirilemez; yeni bir anahtar oluşturun.

Anahtarsız bağlanan yapay zeka asistanları

claude.ai ve ChatGPT anahtar kullanmaz: asistandan Gloriads'e giriş yapar ve İzin ver düğmesine tıklarsınız. Asistan bunun ardından kendi erişimini alır; bu erişim yalnızca okuyabilir. Nasıl bağlanacağı: Yapay zeka asistanı bağlama.

  • Ayarlar → API → Bağlı uygulamalar, her asistanı, erişim isteyen adresi, onu ne zaman bağladığınızı ve hesabınızı en son ne zaman okuduğunu listeler (en fazla saatte bir güncellenir).
  • Bir adın yanındaki Doğrulanmamış, uygulamanın adresini kanıtlamadan kendini kaydettiği anlamına gelir. Yalnızca onu kendiniz bağladıysanız tutun.
  • Birini durdurmak için ⋯ menüsünü açın, ardından Bağlantıyı kes seçeneğini seçin. Hemen geçerli olur. Yeniden kullanmak için asistandan tekrar bağlayın.

Bir istek reddedildiğinde

YanıtNedenNe yapmalı
401 unauthorizedAuthorization başlığı yok ya da anahtar yanlış veya iptal edilmişBaşlığı ve anahtarı kontrol edin
403 subscription_inactiveAboneliğiniz sona erdiAyarlar → Faturalandırma bölümünden abone olun
400 api_key_in_queryAnahtar URL'deydiBaşlığa taşıyın, ardından iptal edin

Diğer tüm kodlar Sınırlar ve hatalar sayfasında açıklanır.

Herkese açık demo anahtarı

API referansı, Try it düğmesini herkese açık bir anahtarla önceden doldurur. Bu anahtar yalnızca demo hesabını okur ve tüm ziyaretçiler arasında paylaşılan dakikada 10 istekle sınırlıdır. Hesabınızı okuyamaz: bunun için kendi anahtarınızı kullanın.