{
    "openapi": "3.1.0",
    "info": {
        "title": "SendeYok Platform API",
        "version": "v1",
        "description": "Mağazanızın ürün, stok ve sipariş verisi için kapsamlı REST, GraphQL ve MCP arayüzleri.\n\nKimlik: `Authorization: Bearer syk_…` (API anahtarı) ya da OAuth 2.0 erişim jetonu `syo_…` (GraphQL).\nTutarlar KURUŞ (int). Hız sınırı anahtar başınadır; aşımda 429 + `Retry-After`."
    },
    "servers": [
        {
            "url": "https://sendeyok.com",
            "description": "Canlı API"
        },
        {
            "url": "https://sendeyok.com",
            "description": "Geliştirici sandbox API"
        }
    ],
    "security": [
        {
            "anahtar": []
        }
    ],
    "paths": {
        "/api/vitrin/eklenti/api_anahtarlari/v1/categories": {
            "get": {
                "summary": "Kategoriler — listele",
                "tags": [
                    "Kategori"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_categories",
                "description": "Gerekli kapsam: `categories:read`.",
                "x-kapsamlar": [
                    "categories:read"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Kategori"
                                            }
                                        },
                                        "sayfa": {
                                            "type": "integer"
                                        },
                                        "son_sayfa": {
                                            "type": "integer"
                                        },
                                        "toplam": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/me": {
            "get": {
                "summary": "Anahtar bilgisi — listele",
                "tags": [
                    "Genel"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_me",
                "description": "Kapsam gerekmez (geçerli anahtar yeter).",
                "x-kapsamlar": [],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/orders": {
            "get": {
                "summary": "Siparişler — listele",
                "tags": [
                    "Siparis"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_orders",
                "description": "Gerekli kapsam: `orders:read`.",
                "x-kapsamlar": [
                    "orders:read"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Siparis"
                                            }
                                        },
                                        "sayfa": {
                                            "type": "integer"
                                        },
                                        "son_sayfa": {
                                            "type": "integer"
                                        },
                                        "toplam": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/orders/{id}": {
            "get": {
                "summary": "Siparişler — tekil getir",
                "tags": [
                    "Siparis"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_orders_id",
                "description": "Gerekli kapsam: `orders:read`.",
                "x-kapsamlar": [
                    "orders:read"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Siparis"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "summary": "Siparişler — güncelle",
                "tags": [
                    "Siparis"
                ],
                "operationId": "patch_api_vitrin_eklenti_api_anahtarlari_v1_orders_id",
                "description": "Gerekli kapsam: `orders:write`.",
                "x-kapsamlar": [
                    "orders:write"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Siparis"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Doğrulama hatası",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/products": {
            "get": {
                "summary": "ürünler — listele",
                "tags": [
                    "Urun"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_products",
                "description": "Gerekli kapsam: `products:read`.",
                "x-kapsamlar": [
                    "products:read"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Urun"
                                            }
                                        },
                                        "sayfa": {
                                            "type": "integer"
                                        },
                                        "son_sayfa": {
                                            "type": "integer"
                                        },
                                        "toplam": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/products/{id}": {
            "get": {
                "summary": "ürünler — tekil getir",
                "tags": [
                    "Urun"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_products_id",
                "description": "Gerekli kapsam: `products:read`.",
                "x-kapsamlar": [
                    "products:read"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Urun"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "summary": "ürünler — güncelle",
                "tags": [
                    "Urun"
                ],
                "operationId": "patch_api_vitrin_eklenti_api_anahtarlari_v1_products_id",
                "description": "Gerekli kapsam: `products:write`.",
                "x-kapsamlar": [
                    "products:write"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Urun"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Doğrulama hatası",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/shipments": {
            "get": {
                "summary": "Kargolar — listele",
                "tags": [
                    "Kargo"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_shipments",
                "description": "Gerekli kapsam: `shipments:read`.",
                "x-kapsamlar": [
                    "shipments:read"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Kargo"
                                            }
                                        },
                                        "sayfa": {
                                            "type": "integer"
                                        },
                                        "son_sayfa": {
                                            "type": "integer"
                                        },
                                        "toplam": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/shipments/{id}": {
            "get": {
                "summary": "Kargolar — tekil getir",
                "tags": [
                    "Kargo"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_shipments_id",
                "description": "Gerekli kapsam: `shipments:read`.",
                "x-kapsamlar": [
                    "shipments:read"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Kargo"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/stock": {
            "get": {
                "summary": "Stok — listele",
                "tags": [
                    "Stok"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_stock",
                "description": "Gerekli kapsam: `stock:read`.",
                "x-kapsamlar": [
                    "stock:read"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Stok"
                                            }
                                        },
                                        "sayfa": {
                                            "type": "integer"
                                        },
                                        "son_sayfa": {
                                            "type": "integer"
                                        },
                                        "toplam": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/stock/{id}": {
            "put": {
                "summary": "Stok — güncelle",
                "tags": [
                    "Stok"
                ],
                "operationId": "put_api_vitrin_eklenti_api_anahtarlari_v1_stock_id",
                "description": "Gerekli kapsam: `stock:write`.",
                "x-kapsamlar": [
                    "stock:write"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Stok"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Doğrulama hatası",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/webhooks": {
            "get": {
                "summary": "Webhook uçları — listele",
                "tags": [
                    "Webhook"
                ],
                "operationId": "get_api_vitrin_eklenti_api_anahtarlari_v1_webhooks",
                "description": "Gerekli kapsam: `webhooks:read`.",
                "x-kapsamlar": [
                    "webhooks:read"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Webhook"
                                            }
                                        },
                                        "sayfa": {
                                            "type": "integer"
                                        },
                                        "son_sayfa": {
                                            "type": "integer"
                                        },
                                        "toplam": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Webhook uçları",
                "tags": [
                    "Webhook"
                ],
                "operationId": "post_api_vitrin_eklenti_api_anahtarlari_v1_webhooks",
                "description": "Gerekli kapsam: `webhooks:write`.",
                "x-kapsamlar": [
                    "webhooks:write"
                ],
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Webhook"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Doğrulama hatası",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/api_anahtarlari/v1/webhooks/{id}": {
            "delete": {
                "summary": "Webhook uçları",
                "tags": [
                    "Webhook"
                ],
                "operationId": "delete_api_vitrin_eklenti_api_anahtarlari_v1_webhooks_id",
                "description": "Gerekli kapsam: `webhooks:write`.",
                "x-kapsamlar": [
                    "webhooks:write"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Başarılı",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Webhook"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Anahtar geçersiz, iptal ya da süresi dolmuş",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Kapsam yetersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Dakika sınırı aşıldı",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        },
                        "headers": {
                            "X-RateLimit-Limit": {
                                "description": "Dakika sınırı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Remaining": {
                                "description": "Kalan istek",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "X-RateLimit-Reset": {
                                "description": "Sıfırlanma Unix zamanı",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "Retry-After": {
                                "description": "Tekrar deneyebilmek için beklenecek saniye",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/gelistirici_portali_ve_graphql/graphql": {
            "post": {
                "summary": "GraphQL sorgusu (salt okunur)",
                "tags": [
                    "GraphQL"
                ],
                "operationId": "graphql",
                "description": "Kapsam alan başınadır: urunler/urun → products:read, stoklar → stock:read, siparisler/siparis → orders:read. Derinlik ≤ 7, karmaşıklık ≤ 400, sayfa ≤ 50.",
                "security": [
                    {
                        "anahtar": []
                    },
                    {
                        "oauth2": [
                            "products:read",
                            "stock:read",
                            "orders:read"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "query"
                                ],
                                "properties": {
                                    "query": {
                                        "type": "string"
                                    },
                                    "variables": {
                                        "type": "object"
                                    },
                                    "operationName": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "GraphQL yanıtı (hatalar `errors` içinde)"
                    },
                    "401": {
                        "description": "Kimlik geçersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/vitrin/eklenti/gelistirici_portali_ve_graphql/oauth/token": {
            "post": {
                "summary": "OAuth 2.0 jeton ucu",
                "tags": [
                    "OAuth"
                ],
                "operationId": "oauthToken",
                "security": [],
                "description": "authorization_code (PKCE S256 zorunlu) ve refresh_token (döner; kullanılan jeton tekrar geçmez). Yanıt: access_token (1 saat), refresh_token (30 gün).",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "grant_type",
                                    "client_id"
                                ],
                                "properties": {
                                    "grant_type": {
                                        "type": "string",
                                        "enum": [
                                            "authorization_code",
                                            "refresh_token"
                                        ]
                                    },
                                    "client_id": {
                                        "type": "string"
                                    },
                                    "client_secret": {
                                        "type": "string"
                                    },
                                    "code": {
                                        "type": "string"
                                    },
                                    "code_verifier": {
                                        "type": "string"
                                    },
                                    "redirect_uri": {
                                        "type": "string"
                                    },
                                    "refresh_token": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Jeton"
                    },
                    "400": {
                        "description": "invalid_grant / invalid_request"
                    },
                    "401": {
                        "description": "invalid_client"
                    }
                }
            }
        },
        "/api/vitrin/eklenti/gelistirici_portali_ve_graphql/oauth/revoke": {
            "post": {
                "summary": "OAuth 2.0 jeton iptali (RFC 7009)",
                "tags": [
                    "OAuth"
                ],
                "operationId": "oauthRevoke",
                "security": [],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "token",
                                    "client_id"
                                ],
                                "properties": {
                                    "token": {
                                        "type": "string"
                                    },
                                    "client_id": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Her durumda 200"
                    }
                }
            }
        },
        "/api/vitrin/eklenti/mcp_ve_cli/mcp": {
            "post": {
                "summary": "MCP sunucusu (JSON-RPC, Streamable HTTP)",
                "tags": [
                    "MCP"
                ],
                "operationId": "mcp",
                "description": "Eklenti `mcp_ve_cli` kuruluysa: Claude / ChatGPT / Cursor gibi istemciler için araçlar. Yazma yalnız ÖNERİdir; mağaza yöneticisi onaylar.",
                "responses": {
                    "200": {
                        "description": "JSON-RPC yanıtı"
                    },
                    "401": {
                        "description": "Kimlik geçersiz",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Hata"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Eklenti kurulu değil"
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "anahtar": {
                "type": "http",
                "scheme": "bearer",
                "description": "API anahtarı (`syk_…`) — panelde API anahtarları ekranından kapsamlı üretilir."
            },
            "oauth2": {
                "type": "oauth2",
                "flows": {
                    "authorizationCode": {
                        "authorizationUrl": "https://sendeyok.com/panel/oauth/yetkilendir",
                        "tokenUrl": "https://sendeyok.com/api/vitrin/eklenti/gelistirici_portali_ve_graphql/oauth/token",
                        "scopes": {
                            "products:read": "Ürünleri oku",
                            "products:write": "Ürün fiyatını yaz",
                            "stock:read": "Stoğu oku",
                            "stock:write": "Stok yaz",
                            "orders:read": "Siparişleri oku",
                            "orders:write": "Sipariş notu / kargo takibi yaz"
                        }
                    }
                }
            }
        },
        "schemas": {
            "Hata": {
                "type": "object",
                "properties": {
                    "kod": {
                        "type": "string"
                    },
                    "message": {
                        "type": "string"
                    }
                }
            },
            "Urun": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "sku": {
                        "type": "string",
                        "nullable": true
                    },
                    "ad": {
                        "type": "string"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "yayinda": {
                        "type": "boolean"
                    },
                    "fiyat_kurus": {
                        "type": "integer"
                    },
                    "indirimli_fiyat_kurus": {
                        "type": "integer",
                        "nullable": true
                    },
                    "indirim_yuzde": {
                        "type": "number"
                    },
                    "guncellendi_at": {
                        "type": "string",
                        "format": "date-time"
                    }
                }
            },
            "Stok": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer"
                    },
                    "sku": {
                        "type": "string",
                        "nullable": true
                    },
                    "adet": {
                        "type": "integer"
                    },
                    "stok_durumu": {
                        "type": "string"
                    },
                    "varyantlar": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variation_id": {
                                    "type": "integer"
                                },
                                "sku": {
                                    "type": "string"
                                },
                                "adet": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            },
            "Siparis": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "siparis_no": {
                        "type": "integer"
                    },
                    "durum": {
                        "type": "string",
                        "nullable": true
                    },
                    "odeme_durumu": {
                        "type": "string"
                    },
                    "toplam_kurus": {
                        "type": "integer"
                    },
                    "kargo_kurus": {
                        "type": "integer"
                    },
                    "para_birimi": {
                        "type": "string"
                    },
                    "olusturuldu_at": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "kalemler": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "product_id": {
                                    "type": "integer"
                                },
                                "ad": {
                                    "type": "string"
                                },
                                "adet": {
                                    "type": "integer"
                                },
                                "birim_fiyat_kurus": {
                                    "type": "integer"
                                },
                                "satir_toplam_kurus": {
                                    "type": "integer"
                                }
                            }
                        }
                    }
                }
            },
            "Kategori": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "ad": {
                        "type": "string"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "parent_id": {
                        "type": "integer",
                        "nullable": true
                    }
                }
            },
            "Kargo": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "siparis_no": {
                        "type": "string"
                    },
                    "durum": {
                        "type": "string",
                        "nullable": true
                    },
                    "takip_no": {
                        "type": "string",
                        "nullable": true
                    },
                    "kargo_firmasi": {
                        "type": "string",
                        "nullable": true
                    },
                    "guncellendi_at": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                    }
                }
            },
            "Webhook": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "ad": {
                        "type": "string",
                        "nullable": true
                    },
                    "adres": {
                        "type": "string",
                        "format": "uri"
                    },
                    "olaylar": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "etkin": {
                        "type": "boolean"
                    },
                    "olusturuldu_at": {
                        "type": "string",
                        "format": "date-time"
                    }
                }
            }
        }
    }
}
