{
    "openapi": "3.1.0",
    "info": {
        "title": "Kooperatifler Kanunu API",
        "version": "1.0.0",
        "description": "Yapay zekâ ajanları için kooperatiflerkanunu.com: 1163 sayılı Kooperatifler Kanunu'nun güncel maddeleri, Kemal Özmen ve Evren Özmen'in rehberlerinden kısa cevaplar, dış denetim ön testi, hizmet kataloğu ve kullanıcının onayıyla danışmanlık talebi. MCP sunucusu: https://kooperatiflerkanunu.com/wp-json/kk/v1/mcp",
        "contact": {
            "name": "Özmen Mali Müşavirlik",
            "email": "info@ozmconsultancy.com",
            "url": "https://kooperatiflerkanunu.com/bize-ulasin/"
        }
    },
    "servers": [
        {
            "url": "https://kooperatiflerkanunu.com/wp-json/kk/v1"
        }
    ],
    "paths": {
        "/hizmetler": {
            "get": {
                "operationId": "hizmetler",
                "summary": "Hizmet kataloğu, uzmanlar, iletişim ve talep yöntemi",
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sorular": {
            "get": {
                "operationId": "sorular",
                "summary": "Kısa cevaplar (soru-cevap derlemi)",
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": false,
                        "description": "İsteğe bağlı filtre",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "description": "En fazla kaç cevap (varsayılan 50)",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ara": {
            "get": {
                "operationId": "ara",
                "summary": "Rehberlerde ve kısa cevaplarda ara",
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": true,
                        "description": "Arama ifadesi veya soru",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/madde/{no}": {
            "get": {
                "operationId": "kanunMaddesi",
                "summary": "1163 sayılı Kanun maddesinin güncel metni",
                "parameters": [
                    {
                        "name": "no",
                        "in": "path",
                        "required": true,
                        "description": "Madde numarası",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "tur",
                        "in": "query",
                        "required": false,
                        "description": "asil (varsayılan), ek veya gecici",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/dis-denetim-testi": {
            "get": {
                "operationId": "disDenetimTesti",
                "summary": "Kooperatif dış denetime tabi mi? (Denetim Yönetmeliği m. 15)",
                "parameters": [
                    {
                        "name": "tur",
                        "in": "query",
                        "required": false,
                        "description": "Kooperatif türü, örneğin konut yapı, tarım satış, tüketim",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "ortak_sayisi",
                        "in": "query",
                        "required": false,
                        "description": "Olağan genel kurulun yapıldığı yılın 1 Ocak tarihindeki ortak sayısı",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "yapi_ruhsati",
                        "in": "query",
                        "required": false,
                        "description": "Yapı ruhsatı alındı mı (yapı, turizm geliştirme ve gayrimenkul işletme kooperatifleri için)",
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "hasilat_son",
                        "in": "query",
                        "required": false,
                        "description": "Son hesap dönemi net satış hasılatı, TL (bağlı ortaklık ve iştirakler dahil)",
                        "schema": {
                            "type": "number"
                        }
                    },
                    {
                        "name": "hasilat_onceki",
                        "in": "query",
                        "required": false,
                        "description": "Bir önceki hesap dönemi net satış hasılatı, TL",
                        "schema": {
                            "type": "number"
                        }
                    },
                    {
                        "name": "ttk_bagimsiz_denetim",
                        "in": "query",
                        "required": false,
                        "description": "Kooperatif TTK'ya göre bağımsız denetime tabi mi",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/talep": {
            "post": {
                "operationId": "danismanlikTalebi",
                "summary": "Kullanıcının onayıyla danışmanlık veya teklif talebi gönder",
                "description": "Yalnızca kullanıcı göndermeyi açıkça onayladıktan sonra çağırın; ad, e-posta ve telefon kullanıcıya ait olmalıdır. Ücretler yayımlanmaz; kapsam ve teklif talepten sonra bildirilir.",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "ad": {
                                        "type": "string",
                                        "description": "Kullanıcının adı soyadı"
                                    },
                                    "eposta": {
                                        "type": "string",
                                        "description": "Kullanıcının e-posta adresi"
                                    },
                                    "telefon": {
                                        "type": "string",
                                        "description": "Kullanıcının telefonu (en az 10 hane)"
                                    },
                                    "kooperatif": {
                                        "type": "string",
                                        "description": "Kooperatifin adı ve ili"
                                    },
                                    "kooperatif_turu": {
                                        "type": "string",
                                        "description": "Örneğin konut yapı, site işletme, tarımsal kalkınma"
                                    },
                                    "konu": {
                                        "type": "string",
                                        "description": "Dış denetim, Uzman mütalaası, Kuruluş, Genel kurul, Ferdileşme ve tapu, Ortaklık ve çıkma, Tasfiye ve tür değişikliği, Vergi ve muhasebe veya Diğer"
                                    },
                                    "mesaj": {
                                        "type": "string",
                                        "description": "Kullanıcının durumu ve talebi (en az 10 karakter)"
                                    },
                                    "kullanici_onayi": {
                                        "type": "boolean",
                                        "description": "Kullanıcı bu talebin ve iletişim bilgilerinin Özmen Mali Müşavirlik'e iletilmesini açıkça onayladı mı? true olmalıdır."
                                    },
                                    "ajan": {
                                        "type": "string",
                                        "description": "Talebi gönderen yapay zekâ ajanının adı (isteğe bağlı)"
                                    }
                                },
                                "required": [
                                    "ad",
                                    "eposta",
                                    "telefon",
                                    "mesaj",
                                    "kullanici_onayi"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Talep alındı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Eksik veya hatalı alan"
                    },
                    "429": {
                        "description": "Kısa sürede çok fazla talep"
                    }
                }
            }
        }
    }
}