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 ek | Ortam | Kö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
| Kapsam | Açtığı | Tür |
|---|---|---|
akis.oku | /v1/ben, /v1/akis, /v1/olaylar, /v1/haberler, /v1/varliklar, /v1/sozluk/* | API |
icerik.indir | /v1/varliklar/:id/dosya | API |
arsiv.ara | /v1/ara | API |
mcp.kullan | MCP sunucusu | MCP |
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 adresler403 ag_disialı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_doldualı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.