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 ve erişim sınırları
AdresFormatEriş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 GETKilitli 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.xmlDüz metin · RSS XMLYayımlanmış kamu istatistikleri ve analizler.
/api/docs · /openapi.json · /.well-known/api-catalogHTML · OpenAPI JSON · Linkset JSONStatik kullanım ve keşif belgeleri; yeni yetki vermez.
/mcpMCP streamable HTTPYalnı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.

Dış Gündem · Yayın ilkeleri