Geliştiriciler: API, MCP ve llms.txt

Makine kapısı

Bir ajan bu siteyi ekran görüntüsünden okumak zorunda değildir. Aşağıdaki dosyalar ve uçlar aynı içerik kaynağından üretilir; bir sayfa değiştiğinde Markdown sürümü, llms dosyaları ve site haritası da değişir.

Adres	Ne verir	Biçim
`/llms.txt`	Sitenin yapay zekâ için özeti: ne yapar, sayfalar, kurallar (llmstxt.org biçimi).	text/plain
`/llms-full.txt`	Bütün sayfaların Markdown metni tek dosyada.	text/plain
`/<sayfa>.md`	Her sayfanın Markdown sürümü; aynı adres `Accept: text/markdown` ile de istenebilir.	text/markdown
`/sitemap.xml`	Bütün dizine açık sayfalar, içerik değiştiğinde güncellenen lastmod ile.	application/xml
`/.well-known/api-catalog`	API kataloğu (RFC 9727): OpenAPI, belgeler, durum ucu ve MCP sunucusu.	application/linkset+json
`/openapi.json`	Hesap ve giriş uçlarının OpenAPI 3.1 tanımı.	application/json
`/mcp`	Model Context Protocol sunucusu (Streamable HTTP): beş deterministik araç.	application/json
`/robots.txt`	Tarama kuralları ve kullanım sinyali: search=yes, ai-input=yes, ai-train=no.	text/plain
`/.well-known/security.txt`	Güvenlik açığı bildirimi (RFC 9116).	text/plain
`/.well-known/gpc.json`	Global Privacy Control desteği.	application/json

Hesap API'si

Ücretsiz araçların hesapları bir API olarak da açıktır. Hesaplar deterministiktir: aynı girdi her zaman aynı sonucu verir; sonuç, girdi ve kuralıyla birlikte SHA-256 ile mühürlenir. Kimlik doğrulama gerekmez; dakikada 60 istekle sınırlıdır.

Yöntem	Uç	Ne yapar
POST	`/api/v1/hesap/fark`	İlave ücret tavanı, fazla, kanuni faiz ve toplam. Gövde: charged, sgk, paid, asOf, exemption.
POST	`/api/v1/hesap/faiz`	Dönemlere bölünmüş kanuni faiz. Gövde: principal, from, to.
GET	`/api/v1/basvuru-yolu?tutar=&yil=`	Tüketici hakem heyeti mi, arabulucu ve mahkeme mi.
GET	`/api/v1/istisnalar`	İlave ücret alınamayan hizmetler ve kişiler.
GET	`/api/v1/oranlar`	Kanuni faiz dönemleri ve hakem heyeti sınırları, kaynaklarıyla.
GET	`/api/v1/sozluk?q=`	Sözlük (DefinedTermSet); q ile arama.

Örnek: fark hesabı

curl -X POST https://av.iadeos.com/api/v1/hesap/fark \
  -H 'Content-Type: application/json' \
  -d '{"charged": 2400, "sgk": 800, "paid": "2026-03-14", "asOf": "2026-10-12"}'

{
  "cap": 1600,
  "excess": 800,
  "total": 922.87,
  "rule": "tavan",
  "interest": {
    "total": 122.87,
    "days": 212,
    "lines": [
      {
        "from": "2026-03-15",
        "to": "2026-07-30",
        "days": 138,
        "rate": 0.24,
        "amount": 72.59,
        "basis": "3095 s.K. m.1 · CB Kararı 8485 (RG 21.05.2024)"
      },
      {
        "from": "2026-07-31",
        "to": "2026-10-12",
        "days": 74,
        "rate": 0.31,
        "amount": 50.28,
        "basis": "3095 s.K. m.1 · 7589 s.K. (RG 31.07.2026), reeskont × %80"
      }
    ]
  },
  "seal": "sha256:…"
}

Örnekteki tutarlar gösterim amaçlıdır; sonuç, sitedeki fark tezgâhıyla aynı koddan çıkar.

MCP sunucusu

Model Context Protocol destekleyen bir istemci, IADEOS'un hesap araçlarını doğrudan çağırabilir. Sunucu Streamable HTTP üzerinden JSON-RPC konuşur; araçların girdileri JSON Schema ile tanımlıdır.

Araç	Ne yapar
`ilave_ucret_farki`	Tavan, fazla, faiz ve toplam
`kanuni_faiz`	Dönem dönem kanuni faiz
`basvuru_yolu`	Tutar ve yıla göre başvuru yolu
`istisnalar`	İlave ücret istisnaları
`sozluk`	Terim tanımı, dayanağı ve kaynağı

{
  "mcpServers": {
    "iadeos": {
      "type": "http",
      "url": "https://av.iadeos.com/mcp"
    }
  }
}

Kullanım

Kullanım sinyali. robots.txt içinde Content-Signal: search=yes, ai-input=yes, ai-train=no: arama ve yanıt için okunabilir, model eğitimi için kullanılmasın.
Alıntı. Bir tanımı ya da kuralı alıntılarken sayfanın bağlantısını verin; her sayfa kaynağını gösterir.
Hukuki görüş değildir. API ve MCP çıktıları hesaptır; somut olay için avukatın değerlendirmesi gerekir.
Tarayıcı konsolu. Her sayfa, hata ve uyarı olmadan yüklenir; bu her ölçümde denetlenir.

Hazırlık ölçümü

Son ölçüm 2026-10-12: Makine Hazırlık Endeksi 18/18 (ölçülebilen denetimler), genişletilmiş denetimler 40/40. Kanıt dosyaları SHA-256 ile mühürlüdür; kayıt zinciri 6 çalıştırma uzunluğundadır.

Ölçüm, bir tez çalışmasındaki 18 denetimli Makine Hazırlık Endeksi'ni (ajanlar, arama, güven, hız) ve IADEOS'a özgü genişletilmiş denetimleri, dışarıdan ve kimlik bilgisi olmadan çalıştırır.

Kaynaklar

The /llms.txt file — a proposal to provide information to help LLMs use websites · J. Howard, 03.09.2024
RFC 9727: api-catalog — a well-known URI and link relation to help discovery of APIs · IETF, 2025
Model Context Protocol — specification · modelcontextprotocol.io
Content Signals Policy (search, ai-input, ai-train) · Cloudflare, 2025
RFC 9116: A File Format to Aid in Security Vulnerability Disclosure (security.txt) · IETF, 2022
Global Privacy Control — specification and /.well-known/gpc.json · globalprivacycontrol.org

IADEOS, makineler için.