{
  "openapi": "3.1.0",
  "info": {
    "title": "Mama Dedektifi — herkese açık veri uçları",
    "version": "1.0.0",
    "description": "Türkiye'de satılan kedi ve köpek mamalarının etiket verileri (garanti edilen analiz, içerik listesi, katkı maddeleri, kilogram fiyatı), salt okunur. Kimlik doğrulama yok. Ürünlere puan verilmez, sıralama ya da öneri yapılmaz.",
    "contact": { "url": "https://mamadedektifi.com/sayfa/iletisim" }
  },
  "servers": [{ "url": "https://mamadedektifi.com" }],
  "paths": {
    "/llms.txt": {
      "get": {
        "summary": "Sitenin yapay zekâ için haritası (llms.txt)",
        "responses": { "200": { "description": "Markdown", "content": { "text/plain": {} } } }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Yayındaki tüm ürünlerin etiket verileri, tek dosyada",
        "responses": { "200": { "description": "Markdown", "content": { "text/plain": {} } } }
      }
    },
    "/mama/{slug}.md": {
      "get": {
        "summary": "Tek ürünün etiket verileri (Markdown)",
        "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Ürün adresi; sitemap.xml ya da llms.txt içinde listelenir" }],
        "responses": { "200": { "description": "Markdown", "content": { "text/markdown": {} } }, "404": { "description": "Ürün yok" } }
      }
    },
    "/{path}": {
      "get": {
        "summary": "Herhangi bir sayfanın Markdown sürümü (içerik anlaşması)",
        "description": "İstekte 'Accept: text/markdown' gönderildiğinde sayfa HTML yerine Markdown döner: başta YAML ön bilgi (başlık, açıklama, kanonik adres), ardından sayfanın ana içeriği ve sonda JSON-LD. Tarayıcılar için varsayılan HTML'dir.",
        "parameters": [
          { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "example": "mama-karsilastir" },
          { "name": "Accept", "in": "header", "required": true, "schema": { "type": "string", "const": "text/markdown" } }
        ],
        "responses": { "200": { "description": "Markdown", "content": { "text/markdown": {} } } }
      }
    },
    "/sitemap.xml": {
      "get": {
        "summary": "Tüm herkese açık sayfaların listesi",
        "responses": { "200": { "description": "XML site haritası", "content": { "application/xml": {} } } }
      }
    }
  }
}