{
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/public/source-stats": {
      "get": {
        "operationId": "LandingSourceStatsPublicController_getSourceStats",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Kaynak istatistikleri",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "sources": {
                          "type": "array",
                          "items": { "type": "object" }
                        },
                        "updatedAt": { "type": "string", "format": "date-time" }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "summary": "Landing source statistics",
        "tags": ["Public Landing"]
      }
    },
    "/api/v1/public/regulations": {
      "get": {
        "description": "Auth gerektirmez; tam içerik ve private alanlar dönmez.",
        "operationId": "PublicRegulationsController_list",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "sourceType",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "source",
            "required": false,
            "in": "query",
            "schema": { "type": "string", "example": "GIB" }
          },
          {
            "name": "sourceCode",
            "required": false,
            "in": "query",
            "schema": { "type": "string", "example": "GIB" }
          },
          {
            "name": "sourceCategory",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "sourceCategories",
            "required": false,
            "in": "query",
            "schema": { "type": "string", "example": "KANUN,TEBLIG" }
          },
          {
            "name": "sourceSubcategory",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "legalDocumentClass",
            "required": false,
            "in": "query",
            "schema": { "type": "string", "example": "HTML" }
          }
        ],
        "responses": {
          "200": {
            "description": "Public mevzuat listesi",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": [
                        "items",
                        "total",
                        "page",
                        "limit",
                        "totalPages"
                      ],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": { "type": "string" },
                              "title": { "type": "string" },
                              "summary": { "type": "string" },
                              "sourceType": { "type": "string" },
                              "sourceCode": {
                                "type": "string",
                                "nullable": true
                              },
                              "externalSourceId": {
                                "type": "string",
                                "nullable": true
                              },
                              "externalRevision": {
                                "type": "string",
                                "nullable": true
                              },
                              "sourceCategory": {
                                "type": "string",
                                "nullable": true
                              },
                              "sourceCategoryLabel": {
                                "type": "string",
                                "nullable": true
                              },
                              "sourceSubcategory": {
                                "type": "string",
                                "nullable": true
                              },
                              "sourceSubcategoryLabel": {
                                "type": "string",
                                "nullable": true
                              },
                              "legalDocumentClass": {
                                "type": "string",
                                "nullable": true
                              },
                              "legalDocumentClassLabel": {
                                "type": "string",
                                "nullable": true
                              },
                              "sourceUrl": {
                                "type": "string",
                                "nullable": true
                              },
                              "originalPdfUrl": {
                                "type": "string",
                                "nullable": true
                              },
                              "officialNumber": {
                                "type": "string",
                                "nullable": true
                              },
                              "officialDate": {
                                "type": "string",
                                "nullable": true
                              },
                              "publishedAt": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "impactLevel": {
                                "type": "string",
                                "nullable": true
                              },
                              "sectors": {
                                "type": "array",
                                "items": { "type": "string" }
                              }
                            }
                          }
                        },
                        "total": { "type": "integer", "minimum": 0 },
                        "page": { "type": "integer", "minimum": 1 },
                        "limit": { "type": "integer", "minimum": 1 },
                        "totalPages": { "type": "integer", "minimum": 0 },
                        "hasMore": { "type": "boolean" },
                        "totalIsEstimated": { "type": "boolean" }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz query",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "summary": "Public landing için güvenli mevzuat listesi",
        "tags": ["Public Landing"]
      }
    },
    "/api/v1/events": {
      "get": {
        "description": "regulations:read. GLOBAL events follow plan source policy; ORG events require the authenticated organization. Live events only; retention is 30 days. Live publications are recorded per regulation after classification completes; no historical backfill is implied.",
        "operationId": "PublicEventsApiController_list",
        "parameters": [
          {
            "name": "after",
            "required": false,
            "in": "query",
            "schema": { "type": "string", "maxLength": 2048 }
          },
          {
            "name": "types",
            "required": false,
            "in": "query",
            "description": "Comma-separated event types; reordering is equivalent",
            "schema": { "type": "string", "maxLength": 1024 }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": ["items", "next_cursor", "has_more"],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "sequence",
                              "event_id",
                              "event_type",
                              "scope",
                              "occurred_at",
                              "livemode",
                              "payload"
                            ],
                            "properties": {
                              "sequence": {
                                "type": "string",
                                "pattern": "^[1-9][0-9]*$"
                              },
                              "event_id": { "type": "string" },
                              "event_type": {
                                "type": "string",
                                "enum": [
                                  "NEW_REGULATION",
                                  "REGULATION_UPDATED",
                                  "REGULATION_CLASSIFICATION_COMPLETED",
                                  "ACTION_DEADLINE_APPROACHING",
                                  "IMPACT_ASSESSMENT_CREATED",
                                  "QUALITY_SLA_BREACH",
                                  "VERIFICATION_COMPLETED",
                                  "VERIFICATION_REVIEW_REQUIRED",
                                  "BOARD_REPORT_READY",
                                  "EVIDENCE_PACK_READY",
                                  "ARTICLE_DIFF_CREATED"
                                ]
                              },
                              "scope": {
                                "type": "string",
                                "enum": ["GLOBAL", "ORG"]
                              },
                              "occurred_at": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "livemode": { "type": "boolean", "enum": [true] },
                              "payload": {
                                "type": "object",
                                "properties": {
                                  "app_url": {
                                    "type": "string",
                                    "format": "uri",
                                    "description": "Canonical application document URL; no token, session, query or fragment. Login requires the existing OTP flow."
                                  },
                                  "public_url": {
                                    "type": "string",
                                    "format": "uri",
                                    "nullable": true,
                                    "description": "Public legislation page only when the canonical public projection admits the document and ROOT_DOMAIN is configured; otherwise null."
                                  },
                                  "sourceCode": { "type": "string" },
                                  "sourceType": { "type": "string" },
                                  "classificationStatus": {
                                    "type": "string",
                                    "enum": ["COMPLETED"]
                                  },
                                  "docsFound": {
                                    "type": "integer",
                                    "enum": [1]
                                  },
                                  "docsNew": { "type": "integer", "enum": [1] },
                                  "regulationIds": {
                                    "type": "array",
                                    "items": { "type": "string" }
                                  }
                                },
                                "additionalProperties": false
                              }
                            }
                          }
                        },
                        "next_cursor": { "type": "string", "nullable": true },
                        "has_more": { "type": "boolean" }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed, tampered or filter-mismatched cursor; invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "410": {
            "description": "cursor_expired: /api/v1/changes ile yeniden doldurun",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate or plan quota exceeded; Retry-After header",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Rate limiter unavailable (fail closed)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Read retained integration events in sequence order",
        "tags": ["Public API"]
      }
    },
    "/api/v1/changes": {
      "get": {
        "operationId": "PublicApiController_listChanges",
        "parameters": [
          {
            "name": "cursor",
            "required": false,
            "in": "query",
            "schema": { "type": "string", "maxLength": 2048 },
            "description": "Signed cursor; empty starts pagination. Mutually exclusive with page."
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "source",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "sourceCode",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "impactLevel",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dateFrom",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dateTo",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": [
                        "items",
                        "total",
                        "page",
                        "limit",
                        "totalPages"
                      ],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "app_url": {
                                "type": "string",
                                "format": "uri",
                                "description": "Canonical application document URL; no token, session, query or fragment. Login requires the existing OTP flow."
                              },
                              "public_url": {
                                "type": "string",
                                "format": "uri",
                                "nullable": true,
                                "description": "Public legislation page only when the canonical public projection admits the document and ROOT_DOMAIN is configured; otherwise null."
                              },
                              "id": { "type": "string" },
                              "title": { "type": "string" },
                              "sourceType": {
                                "type": "string",
                                "example": "BDDK"
                              },
                              "sourceCode": {
                                "type": "string",
                                "nullable": true
                              },
                              "publishedAt": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "effectiveDate": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "taxTags": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "KDV",
                                    "VUK",
                                    "GV",
                                    "KV",
                                    "SGK",
                                    "E_BELGE",
                                    "OTV",
                                    "DAMGA",
                                    "HARC"
                                  ]
                                },
                                "default": []
                              },
                              "complianceDeadline": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "impactLevel": {
                                "type": "string",
                                "example": "HIGH"
                              },
                              "sectors": {
                                "type": "array",
                                "items": { "type": "string" }
                              },
                              "topics": {
                                "type": "array",
                                "items": { "type": "string" }
                              },
                              "summary": { "type": "string", "nullable": true }
                            }
                          }
                        },
                        "total": { "type": "integer", "minimum": 0 },
                        "page": { "type": "integer", "minimum": 1 },
                        "limit": { "type": "integer", "minimum": 1 },
                        "totalPages": { "type": "integer", "minimum": 0 },
                        "hasMore": { "type": "boolean" },
                        "totalIsEstimated": { "type": "boolean" },
                        "meta": {
                          "type": "object",
                          "required": ["nextCursor", "hasMore"],
                          "properties": {
                            "nextCursor": {
                              "type": "string",
                              "nullable": true,
                              "maxLength": 2048
                            },
                            "hasMore": { "type": "boolean" }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Mevzuat değişikliklerini listeler",
        "tags": ["Public API"]
      }
    },
    "/api/v1/deadlines": {
      "get": {
        "operationId": "PublicActionApiController_listDeadlines",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "priority",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dueDateFrom",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dueDateTo",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": [
                        "items",
                        "total",
                        "page",
                        "limit",
                        "totalPages"
                      ],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": { "type": "string" },
                              "title": { "type": "string" },
                              "description": {
                                "type": "string",
                                "nullable": true
                              },
                              "priority": {
                                "type": "string",
                                "example": "HIGH"
                              },
                              "status": { "type": "string", "example": "OPEN" },
                              "dueDate": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "regulationId": {
                                "type": "string",
                                "nullable": true
                              },
                              "department": {
                                "type": "string",
                                "nullable": true
                              },
                              "assignee": {
                                "type": "object",
                                "nullable": true,
                                "description": "API anahtarında people:read gerektirir. İzin yoksa alan tamamen çıkarılır; JWT yanıtı değişmez.",
                                "properties": {
                                  "id": { "type": "string" },
                                  "name": {
                                    "type": "string",
                                    "nullable": true
                                  },
                                  "email": { "type": "string" }
                                }
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "updatedAt": {
                                "type": "string",
                                "format": "date-time"
                              }
                            }
                          }
                        },
                        "total": { "type": "integer", "minimum": 0 },
                        "page": { "type": "integer", "minimum": 1 },
                        "limit": { "type": "integer", "minimum": 1 },
                        "totalPages": { "type": "integer", "minimum": 0 },
                        "hasMore": { "type": "boolean" },
                        "totalIsEstimated": { "type": "boolean" }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Açık uyum deadline listesini döndürür",
        "tags": ["Public Actions"]
      }
    },
    "/api/v1/actions": {
      "get": {
        "operationId": "PublicActionApiController_listActions",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "priority",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dueDateFrom",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dueDateTo",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": [
                        "items",
                        "total",
                        "page",
                        "limit",
                        "totalPages"
                      ],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": { "type": "string" },
                              "title": { "type": "string" },
                              "description": {
                                "type": "string",
                                "nullable": true
                              },
                              "priority": {
                                "type": "string",
                                "example": "HIGH"
                              },
                              "status": { "type": "string", "example": "OPEN" },
                              "dueDate": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "regulationId": {
                                "type": "string",
                                "nullable": true
                              },
                              "department": {
                                "type": "string",
                                "nullable": true
                              },
                              "assignee": {
                                "type": "object",
                                "nullable": true,
                                "description": "API anahtarında people:read gerektirir. İzin yoksa alan tamamen çıkarılır; JWT yanıtı değişmez.",
                                "properties": {
                                  "id": { "type": "string" },
                                  "name": {
                                    "type": "string",
                                    "nullable": true
                                  },
                                  "email": { "type": "string" }
                                }
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "updatedAt": {
                                "type": "string",
                                "format": "date-time"
                              }
                            }
                          }
                        },
                        "total": { "type": "integer", "minimum": 0 },
                        "page": { "type": "integer", "minimum": 1 },
                        "limit": { "type": "integer", "minimum": 1 },
                        "totalPages": { "type": "integer", "minimum": 0 },
                        "hasMore": { "type": "boolean" },
                        "totalIsEstimated": { "type": "boolean" }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Aksiyon maddelerini listeler",
        "tags": ["Public Actions"]
      }
    },
    "/api/v1/verification-reports": {
      "get": {
        "operationId": "PublicVerificationApiController_listRuns",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "sourceType",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "analysisDepth",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "search",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "profileId",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "regulatorCode",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "scenarioKey",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": ["items", "meta"],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": { "type": "string" },
                              "status": { "type": "string" },
                              "sourceType": { "type": "string" },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "completedAt": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              }
                            }
                          }
                        },
                        "meta": {
                          "type": "object",
                          "required": ["total", "page", "limit", "totalPages"],
                          "properties": {
                            "total": { "type": "integer", "minimum": 0 },
                            "page": { "type": "integer", "minimum": 1 },
                            "limit": { "type": "integer", "minimum": 1 },
                            "totalPages": { "type": "integer", "minimum": 1 }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Enterprise verification raporlarını listeler",
        "tags": ["Verification Reports"]
      }
    },
    "/api/v1/verification-reports/{id}": {
      "get": {
        "operationId": "PublicVerificationApiController_getRunDetail",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": { "type": "string" },
                        "status": { "type": "string" },
                        "sourceType": { "type": "string" },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "completedAt": {
                          "type": "string",
                          "format": "date-time",
                          "nullable": true
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Kayıt bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Tek verification raporu detayını döndürür",
        "tags": ["Verification Reports"]
      }
    },
    "/api/v1/board-reports": {
      "get": {
        "operationId": "PublicReportApiController_listReports",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "required": [
                        "items",
                        "total",
                        "page",
                        "limit",
                        "totalPages"
                      ],
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "createdBy": {
                                "type": "object",
                                "nullable": true,
                                "description": "API anahtarında people:read gerektirir. İzin yoksa alan tamamen çıkarılır; JWT yanıtı değişmez.",
                                "properties": {
                                  "id": { "type": "string" },
                                  "name": {
                                    "type": "string",
                                    "nullable": true
                                  },
                                  "email": { "type": "string" }
                                }
                              },
                              "id": { "type": "string" },
                              "title": { "type": "string" },
                              "periodStart": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "periodEnd": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "status": { "type": "string" },
                              "downloadUrl": {
                                "type": "string",
                                "nullable": true
                              }
                            }
                          }
                        },
                        "total": { "type": "integer", "minimum": 0 },
                        "page": { "type": "integer", "minimum": 1 },
                        "limit": { "type": "integer", "minimum": 1 },
                        "totalPages": { "type": "integer", "minimum": 0 },
                        "hasMore": { "type": "boolean" },
                        "totalIsEstimated": { "type": "boolean" }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Kurul raporlarını listeler",
        "tags": ["Board Reports"]
      }
    },
    "/api/v1/board-reports/{id}": {
      "get": {
        "operationId": "PublicReportApiController_getReportDetail",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "createdBy": {
                          "type": "object",
                          "nullable": true,
                          "description": "API anahtarında people:read gerektirir. İzin yoksa alan tamamen çıkarılır; JWT yanıtı değişmez.",
                          "properties": {
                            "id": { "type": "string" },
                            "name": { "type": "string", "nullable": true },
                            "email": { "type": "string" }
                          }
                        },
                        "id": { "type": "string" },
                        "title": { "type": "string" },
                        "periodStart": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "periodEnd": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "status": { "type": "string" },
                        "downloadUrl": { "type": "string", "nullable": true }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Kayıt bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Tek kurul raporu detayını döndürür",
        "tags": ["Board Reports"]
      }
    },
    "/api/v1/evidence-packs/{id}": {
      "get": {
        "operationId": "PublicReportApiController_getEvidencePack",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": { "type": "string" },
                        "title": { "type": "string" },
                        "status": { "type": "string" },
                        "checksum": { "type": "string", "nullable": true },
                        "manifestSignature": {
                          "type": "string",
                          "nullable": true
                        },
                        "downloadUrl": { "type": "string", "nullable": true },
                        "createdAt": { "type": "string", "format": "date-time" }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key veya JWT eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Gerekli API izni yok veya kurum erişimi reddedildi (arşivli kurum)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Kayıt bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Denetim evidence pack detayını döndürür",
        "tags": ["Board Reports"]
      }
    },
    "/api/v1/catalog/search": {
      "get": {
        "description": "Kurumun plan ve kaynak görünürlüğünü korur. effectiveDate resmi açık tarih yoksa null, taxTags kontrollü vergi sözlüğünden bir dizi (eşleşme yoksa []). Kişisel durumlar, kişi alanları, notlar, yorumlar ve açıklama işaretleri döndürülmez.",
        "operationId": "PublicCatalogApiController_search",
        "parameters": [
          {
            "name": "q",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "sourceCode",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dateFrom",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "dateTo",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer", "minimum": 1 }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer", "minimum": 1, "maximum": 100 }
          },
          {
            "name": "semantic",
            "required": false,
            "in": "query",
            "schema": { "type": "boolean", "enum": [false], "default": false },
            "description": "true gönderilirse 400; yalnız tam metin arama desteklenir."
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "effectiveDate": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "taxTags": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "KDV",
                                    "VUK",
                                    "GV",
                                    "KV",
                                    "SGK",
                                    "E_BELGE",
                                    "OTV",
                                    "DAMGA",
                                    "HARC"
                                  ]
                                },
                                "default": []
                              },
                              "app_url": {
                                "type": "string",
                                "format": "uri",
                                "description": "Canonical application document URL; no token, session, query or fragment. Login requires the existing OTP flow."
                              },
                              "public_url": {
                                "type": "string",
                                "format": "uri",
                                "nullable": true,
                                "description": "Public legislation page only when the canonical public projection admits the document and ROOT_DOMAIN is configured; otherwise null."
                              }
                            }
                          }
                        },
                        "titleBand": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "effectiveDate": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "taxTags": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "KDV",
                                    "VUK",
                                    "GV",
                                    "KV",
                                    "SGK",
                                    "E_BELGE",
                                    "OTV",
                                    "DAMGA",
                                    "HARC"
                                  ]
                                },
                                "default": []
                              },
                              "app_url": {
                                "type": "string",
                                "format": "uri",
                                "description": "Canonical application document URL; no token, session, query or fragment. Login requires the existing OTP flow."
                              },
                              "public_url": {
                                "type": "string",
                                "format": "uri",
                                "nullable": true,
                                "description": "Public legislation page only when the canonical public projection admits the document and ROOT_DOMAIN is configured; otherwise null."
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "headers": { "Retry-After": { "schema": { "type": "integer" } } },
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Hız sınırı servisi kullanılamıyor; istek reddedildi.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Katalog: search",
        "tags": ["Public API"]
      }
    },
    "/api/v1/catalog/regulations/{id}": {
      "get": {
        "description": "Kurumun plan ve kaynak görünürlüğünü korur. effectiveDate resmi açık tarih yoksa null, taxTags kontrollü vergi sözlüğünden bir dizi (eşleşme yoksa []). Kişisel durumlar, kişi alanları, notlar, yorumlar ve açıklama işaretleri döndürülmez.",
        "operationId": "PublicCatalogApiController_detail",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          },
          {
            "name": "contentSource",
            "required": false,
            "in": "query",
            "schema": { "enum": ["auto", "text", "pdf"], "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "effectiveDate": {
                          "type": "string",
                          "format": "date-time",
                          "nullable": true
                        },
                        "taxTags": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "KDV",
                              "VUK",
                              "GV",
                              "KV",
                              "SGK",
                              "E_BELGE",
                              "OTV",
                              "DAMGA",
                              "HARC"
                            ]
                          },
                          "default": []
                        },
                        "app_url": {
                          "type": "string",
                          "format": "uri",
                          "description": "Canonical application document URL; no token, session, query or fragment. Login requires the existing OTP flow."
                        },
                        "public_url": {
                          "type": "string",
                          "format": "uri",
                          "nullable": true,
                          "description": "Public legislation page only when the canonical public projection admits the document and ROOT_DOMAIN is configured; otherwise null."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "headers": { "Retry-After": { "schema": { "type": "integer" } } },
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Hız sınırı servisi kullanılamıyor; istek reddedildi.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Katalog: detail",
        "tags": ["Public API"]
      }
    },
    "/api/v1/catalog/sector-taxonomy/active": {
      "get": {
        "description": "Kurumun plan ve kaynak görünürlüğünü korur. effectiveDate resmi açık tarih yoksa null, taxTags kontrollü vergi sözlüğünden bir dizi (eşleşme yoksa []). Kişisel durumlar, kişi alanları, notlar, yorumlar ve açıklama işaretleri döndürülmez.",
        "operationId": "PublicCatalogApiController_active",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": { "type": "object", "additionalProperties": true }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "headers": { "Retry-After": { "schema": { "type": "integer" } } },
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Hız sınırı servisi kullanılamıyor; istek reddedildi.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Katalog: active",
        "tags": ["Public API"]
      }
    },
    "/api/v1/catalog/sector-taxonomy/nodes": {
      "get": {
        "description": "Kurumun plan ve kaynak görünürlüğünü korur. effectiveDate resmi açık tarih yoksa null, taxTags kontrollü vergi sözlüğünden bir dizi (eşleşme yoksa []). Kişisel durumlar, kişi alanları, notlar, yorumlar ve açıklama işaretleri döndürülmez.",
        "operationId": "PublicCatalogApiController_nodes",
        "parameters": [
          {
            "name": "parentKey",
            "required": false,
            "in": "query",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": { "type": "object", "additionalProperties": true }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "headers": { "Retry-After": { "schema": { "type": "integer" } } },
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Hız sınırı servisi kullanılamıyor; istek reddedildi.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Katalog: nodes",
        "tags": ["Public API"]
      }
    },
    "/api/v1/webhooks": {
      "get": {
        "operationId": "WebhookController_list",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string" },
                          "url": { "type": "string", "format": "uri" },
                          "events": {
                            "type": "array",
                            "items": { "type": "string" }
                          },
                          "status": { "type": "string" },
                          "description": { "type": "string", "nullable": true },
                          "includeChildOrgEvents": { "type": "boolean" },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "updatedAt": {
                            "type": "string",
                            "format": "date-time"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Webhook subscription listesini döndürür",
        "tags": ["Webhooks"]
      },
      "post": {
        "operationId": "WebhookController_create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookEndpointDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": { "type": "string" },
                        "url": { "type": "string", "format": "uri" },
                        "events": {
                          "type": "array",
                          "items": { "type": "string" }
                        },
                        "status": { "type": "string" },
                        "description": { "type": "string", "nullable": true },
                        "includeChildOrgEvents": { "type": "boolean" },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updatedAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "secret": {
                          "type": "string",
                          "description": "Yalnız bu yanıtta gösterilir"
                        },
                        "revealedOnce": { "type": "boolean", "enum": [true] }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Yeni webhook subscription oluşturur",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/webhooks/{id}": {
      "get": {
        "operationId": "WebhookController_detail",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": { "type": "string" },
                        "url": { "type": "string", "format": "uri" },
                        "events": {
                          "type": "array",
                          "items": { "type": "string" }
                        },
                        "status": { "type": "string" },
                        "description": { "type": "string", "nullable": true },
                        "includeChildOrgEvents": { "type": "boolean" },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updatedAt": { "type": "string", "format": "date-time" }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Webhook bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Webhook subscription detayını döndürür",
        "tags": ["Webhooks"]
      },
      "put": {
        "operationId": "WebhookController_update",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhookEndpointDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": { "type": "string" },
                        "url": { "type": "string", "format": "uri" },
                        "events": {
                          "type": "array",
                          "items": { "type": "string" }
                        },
                        "status": { "type": "string" },
                        "description": { "type": "string", "nullable": true },
                        "includeChildOrgEvents": { "type": "boolean" },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updatedAt": { "type": "string", "format": "date-time" }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Webhook bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Webhook subscription günceller",
        "tags": ["Webhooks"]
      },
      "delete": {
        "operationId": "WebhookController_remove",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "deleted": { "type": "boolean", "example": true }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Webhook bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Webhook subscription siler",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/webhooks/{id}/test": {
      "post": {
        "operationId": "WebhookController_test",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/TestWebhookDto" }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": { "deliveryId": { "type": "string" } }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Webhook bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Abone olunan türde sentetik test teslimatı kuyruğa alır",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/webhooks/{id}/rotate-secret": {
      "post": {
        "operationId": "WebhookController_rotateSecret",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": { "type": "string" },
                        "url": { "type": "string", "format": "uri" },
                        "events": {
                          "type": "array",
                          "items": { "type": "string" }
                        },
                        "status": { "type": "string" },
                        "description": { "type": "string", "nullable": true },
                        "includeChildOrgEvents": { "type": "boolean" },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updatedAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "secret": {
                          "type": "string",
                          "description": "Yalnız bu yanıtta gösterilir"
                        },
                        "revealedOnce": { "type": "boolean", "enum": [true] },
                        "rotated": { "type": "boolean", "enum": [true] }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Webhook bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Webhook HMAC secret değerini rotate eder",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/webhooks/{id}/deliveries": {
      "get": {
        "operationId": "WebhookController_listDeliveries",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string", "minLength": 8 }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": { "type": "integer" }
          }
        ],
        "responses": {
          "200": {
            "description": "Başarılı yanıt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "data"],
                  "properties": {
                    "success": { "type": "boolean", "enum": [true] },
                    "data": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": { "type": "string" },
                              "status": { "type": "string" },
                              "eventType": { "type": "string" },
                              "responseStatus": {
                                "type": "integer",
                                "nullable": true
                              },
                              "attemptCount": { "type": "integer" },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time"
                              }
                            }
                          }
                        },
                        "meta": {
                          "type": "object",
                          "properties": {
                            "total": { "type": "integer" },
                            "page": { "type": "integer" },
                            "limit": { "type": "integer" },
                            "totalPages": { "type": "integer" }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Geçersiz DTO, URL veya abone olunmayan eventType",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "401": {
            "description": "JWT veya API anahtarı eksik/geçersiz",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "403": {
            "description": "ADMIN/settings izni, Enterprise webhooks:manage veya özellik hakkı yok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Webhook bulunamadı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit aşıldı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "API anahtarı hız sayacı kullanılamıyor",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["type", "title", "status", "detail", "instance"],
                  "properties": {
                    "type": { "type": "string", "example": "about:blank" },
                    "title": { "type": "string", "example": "Forbidden" },
                    "status": { "type": "integer", "example": 403 },
                    "detail": {
                      "type": "string",
                      "example": "Bu işlem için yetkiniz yok"
                    },
                    "instance": {
                      "type": "string",
                      "example": "/api/v1/changes"
                    },
                    "requestId": { "type": "string" },
                    "errorId": { "type": "string" },
                    "success": { "type": "boolean", "example": false },
                    "error": { "type": "string" },
                    "statusCode": { "type": "integer" }
                  }
                }
              }
            }
          }
        },
        "security": [{ "api-key": [] }, { "jwt": [] }],
        "summary": "Webhook delivery geçmişini listeler",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/integration-apps/{id}/webhook": {
      "get": {
        "operationId": "IntegrationWebhookController_get",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          }
        ],
        "responses": { "200": { "description": "" } },
        "security": [{ "jwt": [] }],
        "summary": "Uygulama webhook ucunu oku",
        "tags": ["Webhooks"]
      },
      "put": {
        "operationId": "IntegrationWebhookController_save",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookEndpointDto"
              }
            }
          }
        },
        "responses": { "200": { "description": "" } },
        "security": [{ "jwt": [] }],
        "summary": "Uygulama webhook ucunu kaydet",
        "tags": ["Webhooks"]
      },
      "delete": {
        "operationId": "IntegrationWebhookController_disable",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          }
        ],
        "responses": { "200": { "description": "" } },
        "security": [{ "jwt": [] }],
        "summary": "Uygulama webhook ucunu kapat",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/integration-apps/{id}/webhook/rotate": {
      "post": {
        "operationId": "IntegrationWebhookController_rotate",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          }
        ],
        "responses": { "201": { "description": "" } },
        "security": [{ "jwt": [] }],
        "summary": "Uygulama webhook sırrını yenile",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/integration-apps/{id}/webhook/deliveries": {
      "get": {
        "operationId": "IntegrationWebhookController_deliveries",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          }
        ],
        "responses": { "200": { "description": "" } },
        "security": [{ "jwt": [] }],
        "summary": "Uygulama webhook teslim günlüğünü oku",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/integration/webhook": {
      "get": {
        "operationId": "IntegrationWebhookAppController_get",
        "parameters": [],
        "responses": { "200": { "description": "" } },
        "security": [{ "api-key": [] }],
        "summary": "Uygulama webhook ucunu oku",
        "tags": ["Webhooks"]
      },
      "put": {
        "operationId": "IntegrationWebhookAppController_save",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookEndpointDto"
              }
            }
          }
        },
        "responses": { "200": { "description": "" } },
        "security": [{ "api-key": [] }],
        "summary": "Uygulama webhook ucunu kaydet",
        "tags": ["Webhooks"]
      }
    },
    "/api/v1/integration/grants/{id}": {
      "delete": {
        "operationId": "IntegrationVendorGrantController_revoke",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "İzin iptal edildi; tekrar çağrı aynı sonucu döner"
          },
          "403": {
            "description": "Başka uygulamanın veya var olmayan izin (aynı gövde)"
          }
        },
        "security": [{ "api-key": [] }],
        "summary": "Uygulamanın kendi kurum iznini iptal et",
        "tags": ["Integration"]
      }
    }
  },
  "info": {
    "title": "MevzuatRadar Public API",
    "description": "Public API reference for regulation changes, actions, verification reports, board reports, evidence packs, and webhook subscriptions. URI versioning uses /api/v1 for public/customer/API-key endpoints. Breaking changes require Sunset and successor-version Link headers before removal.",
    "version": "1.0.0",
    "contact": {},
    "license": { "name": "Proprietary", "url": "https://mevzuatradar.com" }
  },
  "tags": [],
  "servers": [
    { "url": "https://api.mevzuatradar.com", "description": "Production" }
  ],
  "components": {
    "securitySchemes": {
      "api-key": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "Public API key created from the admin API keys screen."
      },
      "jwt": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http",
        "description": "Session JWT for authenticated admin webhook operations."
      }
    },
    "schemas": {
      "CreateWebhookEndpointDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "example": "https://example.com/mevzuatradar/webhook"
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "NEW_REGULATION",
                "REGULATION_UPDATED",
                "REGULATION_CLASSIFICATION_COMPLETED",
                "ACTION_DEADLINE_APPROACHING",
                "IMPACT_ASSESSMENT_CREATED",
                "QUALITY_SLA_BREACH",
                "VERIFICATION_COMPLETED",
                "VERIFICATION_REVIEW_REQUIRED",
                "BOARD_REPORT_READY",
                "EVIDENCE_PACK_READY",
                "ARTICLE_DIFF_CREATED"
              ]
            }
          },
          "description": { "type": "string", "maxLength": 500 },
          "includeChildOrgEvents": { "type": "boolean", "default": false }
        },
        "required": ["url", "events"]
      },
      "TestWebhookDto": {
        "type": "object",
        "properties": {
          "eventType": {
            "type": "string",
            "enum": [
              "NEW_REGULATION",
              "REGULATION_UPDATED",
              "REGULATION_CLASSIFICATION_COMPLETED",
              "ACTION_DEADLINE_APPROACHING",
              "IMPACT_ASSESSMENT_CREATED",
              "QUALITY_SLA_BREACH",
              "VERIFICATION_COMPLETED",
              "VERIFICATION_REVIEW_REQUIRED",
              "BOARD_REPORT_READY",
              "EVIDENCE_PACK_READY",
              "ARTICLE_DIFF_CREATED"
            ],
            "default": "NEW_REGULATION"
          }
        }
      },
      "UpdateWebhookEndpointDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "example": "https://example.com/mevzuatradar/webhook"
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "NEW_REGULATION",
                "REGULATION_UPDATED",
                "REGULATION_CLASSIFICATION_COMPLETED",
                "ACTION_DEADLINE_APPROACHING",
                "IMPACT_ASSESSMENT_CREATED",
                "QUALITY_SLA_BREACH",
                "VERIFICATION_COMPLETED",
                "VERIFICATION_REVIEW_REQUIRED",
                "BOARD_REPORT_READY",
                "EVIDENCE_PACK_READY",
                "ARTICLE_DIFF_CREATED"
              ]
            }
          },
          "description": { "type": "string", "maxLength": 500 },
          "status": {
            "type": "string",
            "enum": ["ACTIVE", "PAUSED", "DISABLED"]
          },
          "includeChildOrgEvents": { "type": "boolean" }
        }
      },
      "ApiKeyPermission": {
        "type": "string",
        "enum": [
          "regulations:read",
          "search:read",
          "actions:read",
          "actions:write",
          "verification:read",
          "reports:read",
          "evidence-packs:read",
          "webhooks:manage",
          "people:read"
        ]
      }
    }
  }
}
