{
    "openapi": "3.1.0",
    "info": {
        "title": "ornekfirma.com Örnek REST API",
        "version": "1.0.0",
        "summary": "Türkçe belgeler, eğitimler ve yazılım testleri için ücretsiz, kurgusal örnek veri API'si",
        "description": "ornekfirma.com — example.com'un Türkçe karşılığı — üzerinde çalışan ücretsiz örnek REST API. Anahtar ve kayıt gerektirmez, CORS açıktır. Tüm kişi, firma ve kayıtlar kurgusaldır; gerçek kişi ve kurumlarla benzerlik tesadüftür. GET istekleri gerçek örnek veri döndürür; POST/PUT/PATCH/DELETE istekleri simüle edilir (veri kalıcı olarak değişmez). Kaynakların İngilizce takma adları da çalışır: /users, /companies, /products, /categories, /orders, /invoices, /posts, /comments, /todos.",
        "termsOfService": "https://www.ornekfirma.com/ilkeler.php",
        "contact": {
            "name": "Örnek Firma",
            "url": "https://www.ornekfirma.com"
        }
    },
    "servers": [
        {
            "url": "https://www.ornekfirma.com/api/v1",
            "description": "Üretim"
        }
    ],
    "externalDocs": {
        "description": "API dokümantasyonu",
        "url": "https://www.ornekfirma.com/api.php"
    },
    "tags": [
        {
            "name": "kullanicilar",
            "description": "Kurgusal kullanıcılar (ad, e-posta, telefon, adres, firma bağlantısı)"
        },
        {
            "name": "firmalar",
            "description": "Kurgusal firmalar (unvan, vergi no, IBAN, sektör, adres)"
        },
        {
            "name": "urunler",
            "description": "Kurgusal ürünler (TL fiyat, KDV, stok, barkod, puan)"
        },
        {
            "name": "kategoriler",
            "description": "Ürün kategorileri"
        },
        {
            "name": "siparisler",
            "description": "Kurgusal siparişler (kalemler, tutarlar, kargo takibi, durum)"
        },
        {
            "name": "faturalar",
            "description": "Kurgusal faturalar (e-arşiv/e-fatura, matrah, KDV)"
        },
        {
            "name": "gonderiler",
            "description": "Kurgusal blog yazıları"
        },
        {
            "name": "yorumlar",
            "description": "Gönderilere yapılmış kurgusal yorumlar"
        },
        {
            "name": "gorevler",
            "description": "Kurgusal yapılacak görevler"
        }
    ],
    "paths": {
        "/kullanicilar": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanicilar listesini getirir",
                "description": "Kurgusal kullanıcılar (ad, e-posta, telefon, adres, firma bağlantısı). Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/kullanicilar"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Yeni kullanıcı oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kullanicilar/{id}": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Tek kullanıcı getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/kullanicilar"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kullanicilar/{id}/siparisler": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı kaydına bağlı siparisler listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/siparisler"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kullanicilar/{id}/gonderiler": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı kaydına bağlı gonderiler listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/gonderiler"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kullanicilar/{id}/yorumlar": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı kaydına bağlı yorumlar listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/yorumlar"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kullanicilar/{id}/gorevler": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı kaydına bağlı gorevler listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/gorevler"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kullanicilar/{id}/faturalar": {
            "get": {
                "tags": [
                    "kullanicilar"
                ],
                "summary": "Kullanıcı kaydına bağlı faturalar listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kullanıcı kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/faturalar"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/firmalar": {
            "get": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Firmalar listesini getirir",
                "description": "Kurgusal firmalar (unvan, vergi no, IBAN, sektör, adres). Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/firmalar"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Yeni firma oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/firmalar/{id}": {
            "get": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Tek firma getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Firma kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/firmalar"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Firma değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Firma kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Firma güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Firma kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Firma silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Firma kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/firmalar/{id}/kullanicilar": {
            "get": {
                "tags": [
                    "firmalar"
                ],
                "summary": "Firma kaydına bağlı kullanicilar listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Firma kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/kullanicilar"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/urunler": {
            "get": {
                "tags": [
                    "urunler"
                ],
                "summary": "Urunler listesini getirir",
                "description": "Kurgusal ürünler (TL fiyat, KDV, stok, barkod, puan). Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/urunler"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "urunler"
                ],
                "summary": "Yeni ürün oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/urunler/{id}": {
            "get": {
                "tags": [
                    "urunler"
                ],
                "summary": "Tek ürün getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "ürün kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/urunler"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "urunler"
                ],
                "summary": "ürün değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "ürün kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "urunler"
                ],
                "summary": "ürün güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "ürün kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "urunler"
                ],
                "summary": "ürün silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "ürün kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kategoriler": {
            "get": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Kategoriler listesini getirir",
                "description": "Ürün kategorileri. Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/kategoriler"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Yeni kategori oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kategoriler/{id}": {
            "get": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Tek kategori getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kategori kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/kategoriler"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Kategori değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kategori kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Kategori güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kategori kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Kategori silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kategori kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kategoriler/{id}/urunler": {
            "get": {
                "tags": [
                    "kategoriler"
                ],
                "summary": "Kategori kaydına bağlı urunler listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Kategori kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/urunler"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/siparisler": {
            "get": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Siparisler listesini getirir",
                "description": "Kurgusal siparişler (kalemler, tutarlar, kargo takibi, durum). Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/siparisler"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Yeni sipariş oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/siparisler/{id}": {
            "get": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Tek sipariş getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Sipariş kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/siparisler"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Sipariş değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Sipariş kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Sipariş güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Sipariş kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Sipariş silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Sipariş kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/siparisler/{id}/faturalar": {
            "get": {
                "tags": [
                    "siparisler"
                ],
                "summary": "Sipariş kaydına bağlı faturalar listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Sipariş kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/faturalar"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/faturalar": {
            "get": {
                "tags": [
                    "faturalar"
                ],
                "summary": "Faturalar listesini getirir",
                "description": "Kurgusal faturalar (e-arşiv/e-fatura, matrah, KDV). Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/faturalar"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "faturalar"
                ],
                "summary": "Yeni fatura oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/faturalar/{id}": {
            "get": {
                "tags": [
                    "faturalar"
                ],
                "summary": "Tek fatura getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Fatura kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/faturalar"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "faturalar"
                ],
                "summary": "Fatura değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Fatura kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "faturalar"
                ],
                "summary": "Fatura güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Fatura kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "faturalar"
                ],
                "summary": "Fatura silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Fatura kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gonderiler": {
            "get": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Gonderiler listesini getirir",
                "description": "Kurgusal blog yazıları. Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/gonderiler"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Yeni gönderi oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gonderiler/{id}": {
            "get": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Tek gönderi getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Gönderi kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/gonderiler"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Gönderi değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Gönderi kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Gönderi güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Gönderi kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Gönderi silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Gönderi kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gonderiler/{id}/yorumlar": {
            "get": {
                "tags": [
                    "gonderiler"
                ],
                "summary": "Gönderi kaydına bağlı yorumlar listesini getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Gönderi kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "İlişkili kayıtlar",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/yorumlar"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Üst kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/yorumlar": {
            "get": {
                "tags": [
                    "yorumlar"
                ],
                "summary": "Yorumlar listesini getirir",
                "description": "Gönderilere yapılmış kurgusal yorumlar. Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/yorumlar"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "yorumlar"
                ],
                "summary": "Yeni yorum oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/yorumlar/{id}": {
            "get": {
                "tags": [
                    "yorumlar"
                ],
                "summary": "Tek yorum getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Yorum kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/yorumlar"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "yorumlar"
                ],
                "summary": "Yorum değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Yorum kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "yorumlar"
                ],
                "summary": "Yorum güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Yorum kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "yorumlar"
                ],
                "summary": "Yorum silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Yorum kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gorevler": {
            "get": {
                "tags": [
                    "gorevler"
                ],
                "summary": "Gorevler listesini getirir",
                "description": "Kurgusal yapılacak görevler. Alan adlarıyla eşitlik filtresi uygulanabilir (ör. ?durum=kargoda, ?adres_il=İzmir). Toplam kayıt sayısı X-Toplam-Kayit ve X-Total-Count başlıklarında döner.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/sayfa"
                    },
                    {
                        "$ref": "#/components/parameters/limit"
                    },
                    {
                        "$ref": "#/components/parameters/sirala"
                    },
                    {
                        "$ref": "#/components/parameters/yon"
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/zarf"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt listesi",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/gorevler"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "gorevler"
                ],
                "summary": "Yeni görev oluşturmayı simüle eder",
                "description": "İstek gerçekçi bir yanıtla simüle edilir; veri kalıcı olarak değişmez.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Gövde + yeni id ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gorevler/{id}": {
            "get": {
                "tags": [
                    "gorevler"
                ],
                "summary": "Tek görev getirir",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Görev kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kayıt",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/gorevler"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kayıt bulunamadı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/hata"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "gorevler"
                ],
                "summary": "Görev değiştirmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Görev kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Gönderilen gövde ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "gorevler"
                ],
                "summary": "Görev güncellemeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Görev kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Mevcut kayıt + değişiklikler ile döner (simülasyon)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "gorevler"
                ],
                "summary": "Görev silmeyi simüle eder",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "Görev kimliği",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Silme onayı (simülasyon; veri değişmez)",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "parameters": {
            "sayfa": {
                "name": "_sayfa",
                "in": "query",
                "description": "Sayfa numarası (varsayılan 1). İngilizce eşdeğeri: _page",
                "schema": {
                    "type": "integer",
                    "default": 1
                }
            },
            "limit": {
                "name": "_limit",
                "in": "query",
                "description": "Sayfa başına kayıt (varsayılan 20, en fazla 100)",
                "schema": {
                    "type": "integer",
                    "default": 20,
                    "maximum": 100
                }
            },
            "sirala": {
                "name": "_sirala",
                "in": "query",
                "description": "Sıralanacak alan; nokta gösterimi desteklenir (ör. adres.il). İngilizce eşdeğeri: _sort",
                "schema": {
                    "type": "string"
                }
            },
            "yon": {
                "name": "_yon",
                "in": "query",
                "description": "Sıralama yönü. İngilizce eşdeğeri: _order",
                "schema": {
                    "type": "string",
                    "enum": [
                        "asc",
                        "desc"
                    ],
                    "default": "asc"
                }
            },
            "q": {
                "name": "q",
                "in": "query",
                "description": "Tam metin arama (tüm alanlarda, Türkçe küçük/büyük harf duyarsız)",
                "schema": {
                    "type": "string"
                }
            },
            "zarf": {
                "name": "_zarf",
                "in": "query",
                "description": "1 verilirse yanıt toplam/sayfa bilgisi içeren bir zarfla döner. İngilizce eşdeğeri: _envelope",
                "schema": {
                    "type": "integer",
                    "enum": [
                        0,
                        1
                    ]
                }
            }
        },
        "schemas": {
            "kullanicilar": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "ad": {
                        "type": "string"
                    },
                    "soyad": {
                        "type": "string"
                    },
                    "kullaniciAdi": {
                        "type": "string"
                    },
                    "eposta": {
                        "type": "string"
                    },
                    "telefon": {
                        "type": "string"
                    },
                    "dogumTarihi": {
                        "type": "string"
                    },
                    "firmaId": {
                        "type": "integer"
                    },
                    "unvan": {
                        "type": "string"
                    },
                    "adres": {
                        "type": "object",
                        "properties": {
                            "il": {
                                "type": "string"
                            },
                            "ilce": {
                                "type": "string"
                            },
                            "mahalle": {
                                "type": "string"
                            },
                            "cadde": {
                                "type": "string"
                            },
                            "binaNo": {
                                "type": "string"
                            },
                            "daireNo": {
                                "type": "string"
                            },
                            "postaKodu": {
                                "type": "string"
                            }
                        }
                    },
                    "kayitTarihi": {
                        "type": "string"
                    },
                    "aktif": {
                        "type": "boolean"
                    }
                },
                "description": "Kurgusal kullanıcılar (ad, e-posta, telefon, adres, firma bağlantısı). Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "ad": "Melis",
                    "soyad": "Yıldız",
                    "kullaniciAdi": "melisyildiz74",
                    "eposta": "melisyildiz74@ornekfirma.com",
                    "telefon": "+90 570 348 40 33",
                    "dogumTarihi": "1986-07-14",
                    "firmaId": 7,
                    "unvan": "Pazarlama Müdürü",
                    "adres": {
                        "il": "Bursa",
                        "ilce": "Mudanya",
                        "mahalle": "Fatih Mahallesi",
                        "cadde": "Gazi Bulvarı",
                        "binaNo": "26",
                        "daireNo": "17",
                        "postaKodu": "16580"
                    },
                    "kayitTarihi": "2026-04-13T01:31:49+03:00",
                    "aktif": false
                }
            },
            "firmalar": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "unvan": {
                        "type": "string"
                    },
                    "kisaAd": {
                        "type": "string"
                    },
                    "sektor": {
                        "type": "string"
                    },
                    "vergiNo": {
                        "type": "string"
                    },
                    "vergiDairesi": {
                        "type": "string"
                    },
                    "telefon": {
                        "type": "string"
                    },
                    "eposta": {
                        "type": "string"
                    },
                    "web": {
                        "type": "string"
                    },
                    "iban": {
                        "type": "string"
                    },
                    "calisanSayisi": {
                        "type": "integer"
                    },
                    "kurulusYili": {
                        "type": "integer"
                    },
                    "adres": {
                        "type": "object",
                        "properties": {
                            "il": {
                                "type": "string"
                            },
                            "ilce": {
                                "type": "string"
                            },
                            "mahalle": {
                                "type": "string"
                            },
                            "cadde": {
                                "type": "string"
                            },
                            "binaNo": {
                                "type": "string"
                            },
                            "daireNo": {
                                "type": "string"
                            },
                            "postaKodu": {
                                "type": "string"
                            }
                        }
                    }
                },
                "description": "Kurgusal firmalar (unvan, vergi no, IBAN, sektör, adres). Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "unvan": "Kapadokya Medikal Tic. Ltd. Şti.",
                    "kisaAd": "Kapadokya Medikal",
                    "sektor": "Otomotiv",
                    "vergiNo": "1714428770",
                    "vergiDairesi": "Konak Vergi Dairesi",
                    "telefon": "+90 327 548 69 62",
                    "eposta": "info@kapadokya-medikal1.ornekfirma.com",
                    "web": "https://kapadokya-medikal1.ornekfirma.com",
                    "iban": "TR760000007917065945043767",
                    "calisanSayisi": 25,
                    "kurulusYili": 1995,
                    "adres": {
                        "il": "Gaziantep",
                        "ilce": "Şehitkamil",
                        "mahalle": "Yenimahalle",
                        "cadde": "Barbaros Bulvarı",
                        "binaNo": "62",
                        "daireNo": "14",
                        "postaKodu": "27319"
                    }
                }
            },
            "urunler": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "ad": {
                        "type": "string"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "kategoriId": {
                        "type": "integer"
                    },
                    "aciklama": {
                        "type": "string"
                    },
                    "fiyat": {
                        "type": "integer"
                    },
                    "paraBirimi": {
                        "type": "string"
                    },
                    "kdvOrani": {
                        "type": "integer"
                    },
                    "stok": {
                        "type": "integer"
                    },
                    "barkod": {
                        "type": "string"
                    },
                    "puan": {
                        "type": "number"
                    },
                    "degerlendirmeSayisi": {
                        "type": "integer"
                    },
                    "gorsel": {
                        "type": "string"
                    },
                    "aktif": {
                        "type": "boolean"
                    }
                },
                "description": "Kurgusal ürünler (TL fiyat, KDV, stok, barkod, puan). Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "ad": "Akıllı Telefon 128 GB",
                    "slug": "akilli-telefon-128-gb",
                    "kategoriId": 1,
                    "aciklama": "Akıllı Telefon 128 GB — belgelerde ve testlerde kullanılmak üzere hazırlanmış örnek üründür.",
                    "fiyat": 19220,
                    "paraBirimi": "TRY",
                    "kdvOrani": 20,
                    "stok": 61,
                    "barkod": "8694195335381",
                    "puan": 3.9,
                    "degerlendirmeSayisi": 1122,
                    "gorsel": "https://www.ornekfirma.com/gorsel/urun-1.jpg",
                    "aktif": true
                }
            },
            "kategoriler": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "ad": {
                        "type": "string"
                    },
                    "aciklama": {
                        "type": "string"
                    }
                },
                "description": "Ürün kategorileri. Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "ad": "Elektronik",
                    "aciklama": "Telefon, bilgisayar ve elektronik aksesuarlar"
                }
            },
            "siparisler": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "siparisNo": {
                        "type": "string"
                    },
                    "kullaniciId": {
                        "type": "integer"
                    },
                    "tarih": {
                        "type": "string"
                    },
                    "durum": {
                        "type": "string"
                    },
                    "odemeYontemi": {
                        "type": "string"
                    },
                    "kalemler": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "urunId": {
                                    "type": "integer"
                                },
                                "urunAdi": {
                                    "type": "string"
                                },
                                "adet": {
                                    "type": "integer"
                                },
                                "birimFiyat": {
                                    "type": "integer"
                                },
                                "tutar": {
                                    "type": "integer"
                                }
                            }
                        }
                    },
                    "araToplam": {
                        "type": "number"
                    },
                    "kdvToplam": {
                        "type": "number"
                    },
                    "kargoUcreti": {
                        "type": "integer"
                    },
                    "genelToplam": {
                        "type": "number"
                    },
                    "paraBirimi": {
                        "type": "string"
                    },
                    "kargoFirmasi": {
                        "type": "string"
                    },
                    "kargoTakipNo": {
                        "type": "string"
                    },
                    "teslimatAdresi": {
                        "type": "object",
                        "properties": {
                            "il": {
                                "type": "string"
                            },
                            "ilce": {
                                "type": "string"
                            },
                            "mahalle": {
                                "type": "string"
                            },
                            "cadde": {
                                "type": "string"
                            },
                            "binaNo": {
                                "type": "string"
                            },
                            "daireNo": {
                                "type": "string"
                            },
                            "postaKodu": {
                                "type": "string"
                            }
                        }
                    }
                },
                "description": "Kurgusal siparişler (kalemler, tutarlar, kargo takibi, durum). Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "siparisNo": "SIP-2025-000001",
                    "kullaniciId": 18,
                    "tarih": "2025-03-25T12:17:35+03:00",
                    "durum": "iptal-edildi",
                    "odemeYontemi": "kapida-odeme",
                    "kalemler": [
                        {
                            "urunId": 16,
                            "urunAdi": "Spor Ayakkabı",
                            "adet": 1,
                            "birimFiyat": 1370,
                            "tutar": 1370
                        },
                        {
                            "urunId": 27,
                            "urunAdi": "Nemlendirici Yüz Kremi 50 ml",
                            "adet": 1,
                            "birimFiyat": 459.99,
                            "tutar": 459.99
                        },
                        {
                            "urunId": 24,
                            "urunAdi": "Aromaterapi Difüzörü",
                            "adet": 2,
                            "birimFiyat": 270,
                            "tutar": 540
                        }
                    ],
                    "araToplam": 2369.99,
                    "kdvToplam": 60.73,
                    "kargoUcreti": 0,
                    "genelToplam": 2369.99,
                    "paraBirimi": "TRY",
                    "kargoFirmasi": "Ekspres Dağıtım",
                    "kargoTakipNo": null,
                    "teslimatAdresi": {
                        "il": "Konya",
                        "ilce": "Meram",
                        "mahalle": "Yeşilyurt Mahallesi",
                        "cadde": "Cumhuriyet Caddesi",
                        "binaNo": "81",
                        "daireNo": "6",
                        "postaKodu": "42284"
                    }
                }
            },
            "faturalar": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "faturaNo": {
                        "type": "string"
                    },
                    "siparisId": {
                        "type": "integer"
                    },
                    "kullaniciId": {
                        "type": "integer"
                    },
                    "tip": {
                        "type": "string"
                    },
                    "tarih": {
                        "type": "string"
                    },
                    "matrah": {
                        "type": "number"
                    },
                    "kdvToplam": {
                        "type": "number"
                    },
                    "genelToplam": {
                        "type": "integer"
                    },
                    "paraBirimi": {
                        "type": "string"
                    },
                    "durum": {
                        "type": "string"
                    }
                },
                "description": "Kurgusal faturalar (e-arşiv/e-fatura, matrah, KDV). Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "faturaNo": "OF2025000000001",
                    "siparisId": 2,
                    "kullaniciId": 3,
                    "tip": "e-fatura",
                    "tarih": "2025-07-16T01:11:18+03:00",
                    "matrah": 11260.89,
                    "kdvToplam": 899.11,
                    "genelToplam": 12160,
                    "paraBirimi": "TRY",
                    "durum": "odendi"
                }
            },
            "gonderiler": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "kullaniciId": {
                        "type": "integer"
                    },
                    "baslik": {
                        "type": "string"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "ozet": {
                        "type": "string"
                    },
                    "icerik": {
                        "type": "string"
                    },
                    "etiketler": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "yayinTarihi": {
                        "type": "string"
                    },
                    "goruntulenme": {
                        "type": "integer"
                    },
                    "begeni": {
                        "type": "integer"
                    }
                },
                "description": "Kurgusal blog yazıları. Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "kullaniciId": 26,
                    "baslik": "Küçük işletmeler için dijital pazarlama rehberi",
                    "slug": "kucuk-isletmeler-icin-dijital-pazarlama-rehberi",
                    "ozet": "Küçük işletmeler için dijital pazarlama rehberi hakkında hazırlanmış örnek blog yazısıdır.",
                    "icerik": "Küçük işletmeler için dijital pazarlama rehberi konusunu ele alan bu örnek yazı, ornekfirma.com üzerinde test ve belgeleme amacıyla yayınlanmıştır.\n\nBu içerik gerçek bir tavsiye niteliği taşımaz; API çıktılarında, belge örneklerinde ve yazılım testlerinde serbestçe kullanılabilir. Yazı gövdesi, gerçekçi uzunlukta bir metin ihtiyacını karşılamak için birden fazla paragraftan oluşur.\n\nSonuç olarak, örnek verilerle çalışırken gerçek kişi ve kurum bilgisi kullanmak yerine bu tür hazır içerikleri tercih etmek hem güvenli hem de pratiktir.",
                    "etiketler": [
                        "kobi",
                        "rehber"
                    ],
                    "yayinTarihi": "2026-01-18T08:15:17+03:00",
                    "goruntulenme": 458,
                    "begeni": 191
                }
            },
            "yorumlar": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "gonderiId": {
                        "type": "integer"
                    },
                    "kullaniciId": {
                        "type": "integer"
                    },
                    "ad": {
                        "type": "string"
                    },
                    "eposta": {
                        "type": "string"
                    },
                    "icerik": {
                        "type": "string"
                    },
                    "tarih": {
                        "type": "string"
                    },
                    "begeni": {
                        "type": "integer"
                    }
                },
                "description": "Gönderilere yapılmış kurgusal yorumlar. Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "gonderiId": 1,
                    "kullaniciId": 38,
                    "ad": "Onur Özdemir",
                    "eposta": "onurozdemir52@ornekfirma.com",
                    "icerik": "Bu konuda uzun süredir kaynak arıyordum, teşekkürler.",
                    "tarih": "2026-03-11T04:31:10+03:00",
                    "begeni": 32
                }
            },
            "gorevler": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "kullaniciId": {
                        "type": "integer"
                    },
                    "baslik": {
                        "type": "string"
                    },
                    "oncelik": {
                        "type": "string"
                    },
                    "sonTarih": {
                        "type": "string"
                    },
                    "tamamlandi": {
                        "type": "boolean"
                    }
                },
                "description": "Kurgusal yapılacak görevler. Tüm veriler kurgusaldır.",
                "example": {
                    "id": 1,
                    "kullaniciId": 39,
                    "baslik": "Depo düzenini gözden geçir",
                    "oncelik": "orta",
                    "sonTarih": "2026-10-12",
                    "tamamlandi": true
                }
            },
            "hata": {
                "type": "object",
                "properties": {
                    "hata": {
                        "type": "boolean"
                    },
                    "kod": {
                        "type": "integer"
                    },
                    "mesaj": {
                        "type": "string"
                    }
                }
            }
        }
    }
}
