İçeriğe geç
Belgeler menüsü

Kimlik ve anahtarlar

Her istek Authorization: Bearer <anahtar> başlığı taşır. Anahtar sorgu dizgesinde kabul edilmez (sunucu günlüklerine düşmesin diye).

Anahtar biçimi

yha_canli_ ya da yha_deneme_ ve 43 karakter (256 bit rastgele). Biz yalnızca özetini, ön ekini (yha_canli_8Kq2) ve son dört karakterini saklarız; kaybolan anahtar geri getirilemez, yenisi üretilir.

Ön ekOrtamKök
yha_canli_Canlıhttps://api.<alan>/v1
yha_deneme_Deneme ortamı (örnek içerik)https://deneme.<alan>/v1

Canlı anahtar deneme adresinde, deneme anahtarı canlıda 401 anahtar_ortami_uyusmuyor alır.

Kapsamlar ve tür

KapsamAçtığıTür
akis.oku/v1/ben, /v1/akis, /v1/olaylar, /v1/haberler, /v1/varliklar, /v1/sozluk/*API
icerik.indir/v1/varliklar/:id/dosyaAPI
arsiv.ara/v1/araAPI
mcp.kullanMCP sunucusuMCP

MCP anahtarı yalnızca mcp.kullan taşır, API anahtarı mcp.kullan alamaz: yapay zekâ istemcisinin yapılandırma dosyasına yazılan anahtar dosya indiremez. Kapsam yalnızca uç türünü açar; içerik her zaman paket hakkıyla sınırlıdır.

Daraltma

  • Paket kısıtı: anahtarı yalnızca bazı paketlerinize bağlayabilirsiniz.
  • IP listesi: en çok 20 blok (203.0.113.0/24); listedekiler dışındaki adresler 403 ag_disi alır.
  • Günlük sınır: anahtara kurumun sınırını aşmayan bir günlük istek sınırı koyabilirsiniz.
  • Son kullanma tarihi isteğe bağlıdır.

Döndürme ve iptal

  • Döndür: yeni anahtar üretilir, eskisi seçtiğiniz geçiş süresince (0–168 saat, varsayılan 24) çalışmaya devam eder. Yazılımınızı bu sürede yeni anahtara geçirin; süre dolunca eski anahtar 401 anahtar_suresi_doldu alır.
  • İptal: hemen geçerlidir (açık anlık akış ve MCP bağlantıları birkaç saniye içinde kapanır), geri alınamaz.
  • Anahtar kurumunuzundur; üreten kişi kurumdan ayrılsa da çalışır. Üretme, döndürme ve iptalde kurum yöneticilerine bildirim gider.

Anahtar sızarsa

Hemen iptal edin, yenisini üretin. Anahtarlar ekranındaki "son kullanım IP'si" kimin kullandığını anlamanıza yardım eder.