Dış Gündem — API ve ajan erişimi
Bu arayüzler yayımlanmış kamu verisini okur. Ücretsiz üyelik ve Pro sınırları korunur.
Halka açık nabız API'si
GET /api/nabiz?ulke=gr: kilitli ziyaretçi yanıtı (locked: true; ülke ve katman). Nabız ve ülke profili ücretsiz üyelikle (son 24 saat) ve Pro'da (30 güne kadar) açılır. Desteklenen ülkeler yanıttaki available alanındadır.
OpenAPI 3.1 sözleşmesi. API mevcut JSON hata sözleşmesini korur.
Kullanım örnekleri
Örnek yanıt temsili ve boş bir veri setinden çevrimdışı üretilmiştir; canlı istatistik değildir. available alanı bu örnekte kısaltılmıştır; güncel seçenekler gerçek yanıttadır.
curl 'https://disgundem.com/api/nabiz?ulke=gr'
{
"ok": true,
"available": [
{
"id": "gr",
"name": "Yunanistan"
}
],
"countryId": "gr",
"countryName": "Yunanistan",
"tier": "visitor",
"locked": true,
"titles": false,
"days": 0,
"maxDays": 30,
"tierDays": {
"visitor": 0,
"member": 1,
"pro": 30
},
"dates": [],
"threads": [],
"singles": [],
"daily": [],
"turkeyLens": true,
"preview": null
}
Desteklenmeyen ülke veya yayımlanmamış veri: 404 ve {"ok":false,"error":"…"}. GET dışı yöntem: 405 ve düz metin method. Geçici hata: 500 ve aynı JSON hata sözleşmesi. Hata yanıtları önbelleklenmez.
Adres ve erişim rehberi
| Adres | Format | Erişim sınırı |
|---|---|---|
| / · /haber/{ülke}/{tarih}/{sıra} · /ulke/{ülke} · /bolge/{bölge} · /veri · /veri/konu/{konu} · /analiz · /analiz/{slug} | HTML; Markdown için ?format=md (ya da Accept: text/markdown) | Kimliksiz kamu projeksiyonu. Üye/Pro özeti ve arşiv erişimi açılmaz. |
| /api/nabiz?ulke={kod} | JSON, yalnız GET | Kilitli ziyaretçi yanıtı (profil duvarı): yalnız ülke ve katman; nabız ve ülke profili ücretsiz üyelikle açılır. |
| /llms-full.txt · /analiz/rss.xml | Düz metin · RSS XML | Yayımlanmış kamu istatistikleri ve analizler. |
| /api/docs · /openapi.json · /.well-known/api-catalog | HTML · OpenAPI JSON · Linkset JSON | Statik kullanım ve keşif belgeleri; yeni yetki vermez. |
| /mcp | MCP streamable HTTP | Yalnız sahibin yetkilendirdiği yönetim istemcisi; OAuth/Bearer ve mcp:admin gerekir. |
İçerik okuma
Ana sayfa, haber, ülke, bölge, veri ve analiz adreslerinde Markdown için ?format=md eklenir (önbelleklenir); Accept: text/markdown da kabul edilir ama bu yanıt CDN'de önbelleklenmez. Yanıt yalnız ziyaretçinin erişebildiği metindir. Bilinen sayfalarda HTML varsayılandır. Bilinmeyen rotalarda Accept belirtmeyen veya yalnız */* kabul eden istemciler ve JSON isteyen istemciler RFC 9457 problem yanıtı alır; bilinen HTML/Markdown içerik için JSON isteği 406 döner.
Halka açık API kataloğu · İçerik rehberi · Güncel düz metin beslemesi · Analiz RSS
Markdown ve hata örnekleri
curl 'https://disgundem.com/analiz?format=md'
curl -H 'Accept: application/problem+json' 'https://disgundem.com/__ornek_bulunamayan_adres__'
İkinci istek 404 döner. Temsili hata gövdesi:
{"type":"about:blank","title":"Bu adres bulunamadı.","status":404,"instance":"/__ornek_bulunamayan_adres__"}
Bilinen içerik adresine JSON isteği 406; geçici makine içerik hatası 503; kota aşımı 429 ve Retry-After döner. Makine problem yanıtlarının Content-Type değeri application/problem+json, Cache-Control değeri no-store olur. API nabız hatası ayrı mevcut JSON sözleşmesidir. 429 sonrası Retry-After süresini bekleyin; 404/406 için aynı isteği tekrarlamayın. HTML önbelleği max-age=300, s-maxage=3600; Markdown aynı sürelerle ayrıca stale-while-revalidate=86400 kullanır; nabız önbelleği max-age=300, s-maxage=900.
MCP yönetim erişimi
/mcp mevcut sahibin yetkilendirdiği yönetim istemcileri içindir. OAuth/PKCE veya mevcut sahip Bearer anahtarı gerekir. Anonim araç erişimi, otomatik kamu hesabı açma ve ajan ödeme servisi yoktur. Anahtarlar bu dokümantasyonda bulunmaz; yönetim araçları yalnız yetkili protokol bağlantısında listelenir.
Keşif belgesi · Deneysel AI kataloğu · Deneysel server-card · OAuth kaynak metadatası · OAuth sunucu metadatası
Server-card keşfi taslaktır; kesinleşmiş standart uyumluluğu iddia edilmez. Belge mevcut çalışma zamanı kimliğini korur.
Trafik ve önbellek
Yeni Markdown/JSON içerik isteklerinde işlev örneği başına ve IP başına dakikada 120 origin isteği sınırı uygulanır. Bu küresel/distribüe kota değildir; CDN'den karşılanan istekler origin sayacına girmez. Kota durumu Firestore'a yazılmaz. 429 yanıtı Retry-After içerir ve önbelleklenmez. Normal HTML gezintisi, mevcut nabız API'si ve statik metadata bu sınıra dahil değildir. Önbellekli yanıtta kişisel kalan kota gönderilmez.