{
  "openapi": "3.1.0",
  "info": {
    "title": "Arıza Kodu Çözümü API",
    "version": "1.1.0",
    "description": "Arıza kodu arama ve tek kod sorgulama. Salt okunur, kimlik doğrulama gerekmez."
  },
  "servers": [
    {
      "url": "https://arizakoducozumu.com"
    }
  ],
  "paths": {
    "/api/ara": {
      "get": {
        "operationId": "kodAra",
        "summary": "Kod, marka ya da belirtiye göre ara",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80
            },
            "description": "ör. e18, \"bosch e18\", \"kombi basınç\""
          },
          {
            "name": "cat",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "cihaz slug: camasir-makinesi, bulasik-makinesi, buzdolabi, kombi, klima, firin, kurutma-makinesi, sofben, termosifon"
          },
          {
            "name": "brand",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "marka slug: bosch, arcelik, samsung, lg, vaillant ..."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sonuçlar"
          }
        }
      }
    },
    "/api/kod": {
      "get": {
        "operationId": "kodGetir",
        "summary": "Tek bir kodun tam kaydı",
        "parameters": [
          {
            "name": "cat",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "brand",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "ör. e18, f22, 4c"
          }
        ],
        "responses": {
          "200": {
            "description": "Kod kaydı"
          },
          "404": {
            "description": "Bulunamadı"
          }
        }
      }
    }
  }
}