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: başlıksız yedi günlük ziyaretçi verisi. Desteklenen ülkeler yanıttaki available alanındadır. onizleme=1 yalnız başlıksız 30 günlük şekil önizlemesini ekler; Pro başlıkları ve Türkiye sayıları açılmaz.

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",
  "days": 7,
  "maxDays": 30,
  "titles": false,
  "dates": [
    "2026-09-26",
    "2026-09-27",
    "2026-09-28",
    "2026-09-29",
    "2026-09-30",
    "2026-10-01",
    "2026-10-02"
  ],
  "threads": [],
  "singles": [
    {
      "day": 0,
      "count": 0
    },
    {
      "day": 1,
      "count": 0
    },
    {
      "day": 2,
      "count": 0
    },
    {
      "day": 3,
      "count": 0
    },
    {
      "day": 4,
      "count": 0
    },
    {
      "day": 5,
      "count": 0
    },
    {
      "day": 6,
      "count": 0
    }
  ],
  "daily": [
    {
      "dateId": "2026-09-26",
      "published": false,
      "stories": 0,
      "categories": {}
    },
    {
      "dateId": "2026-09-27",
      "published": false,
      "stories": 0,
      "categories": {}
    },
    {
      "dateId": "2026-09-28",
      "published": false,
      "stories": 0,
      "categories": {}
    },
    {
      "dateId": "2026-09-29",
      "published": false,
      "stories": 0,
      "categories": {}
    },
    {
      "dateId": "2026-09-30",
      "published": false,
      "stories": 0,
      "categories": {}
    },
    {
      "dateId": "2026-10-01",
      "published": false,
      "stories": 0,
      "categories": {}
    },
    {
      "dateId": "2026-10-02",
      "published": true,
      "stories": 0,
      "categories": {}
    }
  ],
  "insights": {},
  "totalStories": 0,
  "categoryTotals": {},
  "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

İçerik okuma

Ana sayfa, haber, ülke, bölge, veri ve analiz adreslerinde Accept: text/markdown gönderilebilir. 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 -H 'Accept: text/markdown' 'https://disgundem.com/analiz'
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