{
  "openapi": "3.1.0",
  "jsonSchemaDialect": "https://spec.openapis.org/oas/3.1/dialect/base",
  "info": {
    "title": "hacumre.co.uk Umre Programları API",
    "version": "1.0.0",
    "summary": "2026–2027 Umre programları için salt okunur, kimlik doğrulamasız JSON API.",
    "description": "Herkese açık, salt okunur bilgi API'si. Aynı veriler MCP uç noktasından (/mcp) da sunulur.\n\n**Veri kuralları:**\n- Bu API yalnızca bilgilendirme amaçlıdır ve salt okunurdur: rezervasyon oluşturmaz, ödeme kabul etmez, müşteri verisi toplamaz veya saklamaz.\n- Fiyatlar USD cinsinden kaynak liste fiyatlarıdır (sourcePrices). Kaynakta hareket noktası belirtilmemiştir; fiyatlar İstanbul veya Londra çıkışı için doğrulanmamıştır (departureOptions[].prices = null, availabilityStatus = \"inquiry_required\").\n- Fiyatların kişi başı olup olmadığı ve fiyata dahil hizmetler kaynakta belirtilmemiştir; bu bilgiler doğrudan teyit edilmelidir.\n- departureDateStatus = \"to-confirm\" olan programların (ör. program 11 ve 12) gidiş tarihi kesinleşmemiştir; departureDate bu durumda null döner.\n- Otel adları kaynakta örnek olarak (vb.) verilmiştir (hotels.hotelsAreExamples). Örnek tur programları (isSample = true) kesinleşmiş günlük plan veya uçuş planı değildir.\n- Her yanıtın meta.disclaimers alanı bu kuralları içerir; yapay zekâ asistanları ve entegrasyonlar bu notları korumalıdır.",
    "contact": {
      "name": "hacumre.co.uk",
      "url": "https://hacumre.co.uk/ai"
    }
  },
  "servers": [
    {
      "url": "https://hacumre.co.uk",
      "description": "Üretim"
    }
  ],
  "externalDocs": {
    "description": "Yapay zekâ entegrasyonları (MCP ve API)",
    "url": "https://hacumre.co.uk/ai"
  },
  "security": [],
  "tags": [
    {
      "name": "Umre",
      "description": "Umre programları, örnek tur programları ve meta veriler"
    }
  ],
  "paths": {
    "/api/v1/umrah/packages": {
      "get": {
        "tags": [
          "Umre"
        ],
        "operationId": "searchUmrahPackages",
        "summary": "Umre programlarını ara ve listele",
        "description": "Filtrelenmiş ve sıralanmış program listesi. Bilinmeyen veya yinelenen parametre 400 döner. Ay filtresinde tarihi kesinleşmemiş programlar dahil edilmez (notes ve excluded alanlarında belirtilir).",
        "parameters": [
          {
            "name": "departureCity",
            "in": "query",
            "description": "Hareket şehri tercihi. Fiyatlar bu şehirler için doğrulanmamıştır; filtre yalnızca seçenek bilgisini döndürür.",
            "schema": {
              "type": "string",
              "enum": [
                "Istanbul",
                "London"
              ]
            }
          },
          {
            "name": "durationDays",
            "in": "query",
            "description": "Program süresi (gün).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 365
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Gidiş ayı (YYYY-MM). Tarihi kesinleşmemiş programlar hariç tutulur.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
            }
          },
          {
            "name": "packageType",
            "in": "query",
            "description": "Program türü.",
            "schema": {
              "type": "string",
              "enum": [
                "servisli",
                "yakin",
                "bes-yildiz",
                "ramazan"
              ]
            }
          },
          {
            "name": "roomType",
            "in": "query",
            "description": "Oda tipi; fiyat filtresi ve sıralama bu oda fiyatına göre uygulanır.",
            "schema": {
              "type": "string",
              "enum": [
                "double",
                "triple",
                "quad"
              ]
            }
          },
          {
            "name": "minPrice",
            "in": "query",
            "description": "En düşük liste fiyatı (USD).",
            "schema": {
              "type": "number",
              "minimum": 0
            }
          },
          {
            "name": "maxPrice",
            "in": "query",
            "description": "En yüksek liste fiyatı (USD). minPrice > maxPrice ise 400.",
            "schema": {
              "type": "number",
              "minimum": 0
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sıralama.",
            "schema": {
              "type": "string",
              "enum": [
                "price-asc",
                "price-desc",
                "duration-asc",
                "duration-desc"
              ],
              "default": "price-asc"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Sayfa boyutu.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Sayfalama başlangıcı.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Program listesi",
            "headers": {
              "RateLimit-Limit": {
                "description": "Pencere başına izin verilen istek sayısı (istemci IP başına).",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Penceredeki kalan istek sayısı.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Pencerenin sıfırlanmasına kalan saniye.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Request-Id": {
                "description": "İsteğin benzersiz kimliği (destek için).",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Cache-Control": {
                "description": "Önbellek politikası.",
                "schema": {
                  "type": "string",
                  "const": "public, max-age=300"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PackageList"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/InvalidParameter"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "405": {
            "$ref": "#/components/responses/MethodNotAllowed"
          },
          "413": {
            "$ref": "#/components/responses/PayloadTooLarge"
          },
          "414": {
            "$ref": "#/components/responses/UriTooLong"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "502": {
            "$ref": "#/components/responses/BadGateway"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          },
          "504": {
            "$ref": "#/components/responses/GatewayTimeout"
          }
        }
      }
    },
    "/api/v1/umrah/packages/{slug}": {
      "get": {
        "tags": [
          "Umre"
        ],
        "operationId": "getUmrahPackage",
        "summary": "Tek bir Umre programının ayrıntısı",
        "description": "Konaklama açıklamalarını da içeren ayrıntı. Sorgu parametresi kabul edilmez (400).",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Paket kısa adı (ör. sitedeki /umre/{slug} adresiyle aynı).",
            "schema": {
              "type": "string",
              "enum": [
                "1-8-gunluk-bes-yildiz-umre",
                "2-14-gunluk-servisli-umre",
                "3-10-gunluk-servisli-umre",
                "4-10-gunluk-yakin-umre",
                "5-20-gunluk-servisli-umre",
                "6-14-gunluk-servisli-umre",
                "7-20-gunluk-servisli-umre",
                "8-10-gunluk-servisli-umre-okul-tatili",
                "9-10-gunluk-yakin-umre-okul-tatili",
                "10-10-gunluk-bes-yildiz-umre-okul-tatili",
                "11-14-gunluk-servisli-umre-okul-tatili",
                "12-14-gunluk-yakin-umre-okul-tatili",
                "13-8-gunluk-servisli-umre-okul-tatili",
                "14-8-gunluk-yakin-umre-okul-tatili",
                "15-8-gunluk-bes-yildiz-umre-okul-tatili",
                "16-61-gunluk-ramazan-umre",
                "17-44-gunluk-ramazan-umre",
                "18-44-gunluk-ramazan-umre",
                "19-13-gunluk-servisli-umre",
                "20-14-gunluk-servisli-umre"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Program ayrıntısı",
            "headers": {
              "RateLimit-Limit": {
                "description": "Pencere başına izin verilen istek sayısı (istemci IP başına).",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Penceredeki kalan istek sayısı.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Pencerenin sıfırlanmasına kalan saniye.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Request-Id": {
                "description": "İsteğin benzersiz kimliği (destek için).",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Cache-Control": {
                "description": "Önbellek politikası.",
                "schema": {
                  "type": "string",
                  "const": "public, max-age=300"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PackageDetailResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/InvalidParameter"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "405": {
            "$ref": "#/components/responses/MethodNotAllowed"
          },
          "413": {
            "$ref": "#/components/responses/PayloadTooLarge"
          },
          "414": {
            "$ref": "#/components/responses/UriTooLong"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "502": {
            "$ref": "#/components/responses/BadGateway"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          },
          "504": {
            "$ref": "#/components/responses/GatewayTimeout"
          }
        }
      }
    },
    "/api/v1/umrah/itineraries/{id}": {
      "get": {
        "tags": [
          "Umre"
        ],
        "operationId": "getUmrahItinerary",
        "summary": "Örnek günlük tur programı",
        "description": "Örnek programdır; kesinleşmiş günlük plan veya uçuş planı değildir. Sorgu parametresi kabul edilmez (400).",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Örnek program kimliği.",
            "schema": {
              "type": "string",
              "enum": [
                "ornek-8-gun",
                "ornek-10-gun",
                "ornek-14-gun",
                "ornek-20-gun"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Örnek tur programı",
            "headers": {
              "RateLimit-Limit": {
                "description": "Pencere başına izin verilen istek sayısı (istemci IP başına).",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Penceredeki kalan istek sayısı.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Pencerenin sıfırlanmasına kalan saniye.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Request-Id": {
                "description": "İsteğin benzersiz kimliği (destek için).",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Cache-Control": {
                "description": "Önbellek politikası.",
                "schema": {
                  "type": "string",
                  "const": "public, max-age=300"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ItineraryResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/InvalidParameter"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "405": {
            "$ref": "#/components/responses/MethodNotAllowed"
          },
          "413": {
            "$ref": "#/components/responses/PayloadTooLarge"
          },
          "414": {
            "$ref": "#/components/responses/UriTooLong"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "502": {
            "$ref": "#/components/responses/BadGateway"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          },
          "504": {
            "$ref": "#/components/responses/GatewayTimeout"
          }
        }
      }
    },
    "/api/v1/umrah/metadata": {
      "get": {
        "tags": [
          "Umre"
        ],
        "operationId": "getUmrahMetadata",
        "summary": "Filtreler, sözlükler ve uç nokta listesi",
        "description": "Sorgu parametresi kabul edilmez (400).",
        "responses": {
          "200": {
            "description": "Meta veriler",
            "headers": {
              "RateLimit-Limit": {
                "description": "Pencere başına izin verilen istek sayısı (istemci IP başına).",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Penceredeki kalan istek sayısı.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Pencerenin sıfırlanmasına kalan saniye.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Request-Id": {
                "description": "İsteğin benzersiz kimliği (destek için).",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Cache-Control": {
                "description": "Önbellek politikası.",
                "schema": {
                  "type": "string",
                  "const": "public, max-age=300"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MetadataResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/InvalidParameter"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "405": {
            "$ref": "#/components/responses/MethodNotAllowed"
          },
          "413": {
            "$ref": "#/components/responses/PayloadTooLarge"
          },
          "414": {
            "$ref": "#/components/responses/UriTooLong"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "502": {
            "$ref": "#/components/responses/BadGateway"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          },
          "504": {
            "$ref": "#/components/responses/GatewayTimeout"
          }
        }
      }
    }
  },
  "components": {
    "responses": {
      "InvalidParameter": {
        "description": "Geçersiz, bilinmeyen veya yinelenen parametre (error.code = \"invalid_parameter\").",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "NotFound": {
        "description": "Paket veya örnek program bulunamadı (error.code = \"not_found\").",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Forbidden": {
        "description": "İzin verilmeyen Host başlığı (error.code = \"forbidden\").",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "MethodNotAllowed": {
        "description": "Yalnızca GET ve HEAD desteklenir (error.code = \"method_not_allowed\").",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          "Allow": {
            "schema": {
              "type": "string",
              "const": "GET, HEAD"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "UriTooLong": {
        "description": "İstek adresi 2048 karakteri aşıyor (error.code = \"uri_too_long\").",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "RateLimited": {
        "description": "İstek sınırı aşıldı (error.code = \"rate_limited\"). Varsayılan: istemci IP başına 60 saniyede 120 istek.",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          "Retry-After": {
            "description": "Yeniden denemeden önce beklenecek saniye.",
            "schema": {
              "type": "integer"
            }
          },
          "RateLimit-Limit": {
            "description": "Pencere başına izin verilen istek sayısı (istemci IP başına).",
            "schema": {
              "type": "integer"
            }
          },
          "RateLimit-Remaining": {
            "description": "Penceredeki kalan istek sayısı.",
            "schema": {
              "type": "integer"
            }
          },
          "RateLimit-Reset": {
            "description": "Pencerenin sıfırlanmasına kalan saniye.",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "InternalError": {
        "description": "Beklenmeyen sunucu hatası (error.code = \"internal_error\"; details içinde requestId).",
        "headers": {
          "X-Request-Id": {
            "description": "İsteğin benzersiz kimliği (destek için).",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "PayloadTooLarge": {
        "description": "İstek gövdesi 64 KB sınırını aşıyor (error.code = \"payload_too_large\"). API yalnızca GET/HEAD kabul eder; gövde gönderilmemelidir. Bu yanıtı API uygulaması değil, ağ geçidi (nginx) üretir; X-Request-Id ve RateLimit-* başlıkları bulunmaz.",
        "headers": {
          "Cache-Control": {
            "description": "Hata yanıtı önbelleğe alınmaz.",
            "schema": {
              "type": "string",
              "const": "no-store"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "BadGateway": {
        "description": "API servisine ulaşılamıyor (error.code = \"service_unavailable\"). Bu yanıtı API uygulaması değil, ağ geçidi (nginx) üretir; X-Request-Id ve RateLimit-* başlıkları bulunmaz.",
        "headers": {
          "Cache-Control": {
            "description": "Hata yanıtı önbelleğe alınmaz.",
            "schema": {
              "type": "string",
              "const": "no-store"
            }
          },
          "Retry-After": {
            "description": "Yeniden denemeden önce beklenecek saniye.",
            "schema": {
              "type": "integer",
              "const": 30
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "API servisi geçici olarak kullanılamıyor (error.code = \"service_unavailable\"). Bu yanıtı API uygulaması değil, ağ geçidi (nginx) üretir; X-Request-Id ve RateLimit-* başlıkları bulunmaz.",
        "headers": {
          "Cache-Control": {
            "description": "Hata yanıtı önbelleğe alınmaz.",
            "schema": {
              "type": "string",
              "const": "no-store"
            }
          },
          "Retry-After": {
            "description": "Yeniden denemeden önce beklenecek saniye.",
            "schema": {
              "type": "integer",
              "const": 30
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "GatewayTimeout": {
        "description": "API servisi zamanında yanıt vermedi (error.code = \"service_unavailable\"). Bu yanıtı API uygulaması değil, ağ geçidi (nginx) üretir; X-Request-Id ve RateLimit-* başlıkları bulunmaz.",
        "headers": {
          "Cache-Control": {
            "description": "Hata yanıtı önbelleğe alınmaz.",
            "schema": {
              "type": "string",
              "const": "no-store"
            }
          },
          "Retry-After": {
            "description": "Yeniden denemeden önce beklenecek saniye.",
            "schema": {
              "type": "integer",
              "const": 30
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "details"
            ],
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "invalid_parameter",
                  "not_found",
                  "forbidden",
                  "method_not_allowed",
                  "uri_too_long",
                  "rate_limited",
                  "internal_error",
                  "payload_too_large",
                  "service_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "Türkçe, insan tarafından okunabilir açıklama."
              },
              "details": {
                "type": "array",
                "items": {
                  "type": "object",
                  "description": "Ör. { param, reason, allowed } veya { path } veya { requestId }."
                }
              }
            }
          }
        }
      },
      "Meta": {
        "type": "object",
        "required": [
          "apiVersion",
          "currency",
          "dataVersion",
          "source",
          "disclaimers"
        ],
        "additionalProperties": false,
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "v1"
          },
          "currency": {
            "type": "string",
            "const": "USD"
          },
          "dataVersion": {
            "type": "string",
            "description": "Yayımlanan veri kümesinin içerik özeti."
          },
          "source": {
            "type": "object",
            "required": [
              "version",
              "file",
              "sheet",
              "sha256",
              "lastSavedAt",
              "lastSavedAtNote",
              "extractedAt",
              "pricesValidAsOf"
            ],
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "string"
              },
              "file": {
                "type": "string"
              },
              "sheet": {
                "type": "string"
              },
              "sha256": {
                "type": "string",
                "pattern": "^[0-9a-f]{64}$"
              },
              "lastSavedAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "lastSavedAtNote": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "extractedAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "pricesValidAsOf": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Kaynakta belirtilmemişse null."
              }
            }
          },
          "disclaimers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1
          }
        }
      },
      "Prices": {
        "type": "object",
        "required": [
          "double",
          "triple",
          "quad"
        ],
        "additionalProperties": false,
        "description": "Oda tipine göre kaynak liste fiyatı (USD). Hareket noktası belirtilmemiştir.",
        "properties": {
          "double": {
            "type": "number",
            "minimum": 0
          },
          "triple": {
            "type": "number",
            "minimum": 0
          },
          "quad": {
            "type": "number",
            "minimum": 0
          }
        }
      },
      "DepartureOption": {
        "type": "object",
        "required": [
          "city",
          "availabilityStatus",
          "prices",
          "note"
        ],
        "additionalProperties": false,
        "properties": {
          "city": {
            "type": "string",
            "enum": [
              "Istanbul",
              "London"
            ]
          },
          "availabilityStatus": {
            "type": "string",
            "enum": [
              "inquiry_required"
            ]
          },
          "prices": {
            "type": "null",
            "description": "Şehre özgü fiyat doğrulanmadığı için her zaman null."
          },
          "note": {
            "type": "string"
          }
        }
      },
      "Package": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "programNumber",
          "title",
          "sourceTitle",
          "durationDays",
          "packageType",
          "packageTypeLabel",
          "schoolHoliday",
          "departureDate",
          "departureDateStatus",
          "departureDateText",
          "currency",
          "sourcePrices",
          "lowestSourcePrice",
          "priceStatus",
          "departureOptions",
          "hotels",
          "nights",
          "itinerary",
          "links",
          "sourceRowNumber"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "programNumber": {
            "type": "integer",
            "minimum": 1
          },
          "title": {
            "type": "string"
          },
          "sourceTitle": {
            "type": "string"
          },
          "durationDays": {
            "type": "integer",
            "minimum": 1
          },
          "packageType": {
            "type": "string",
            "enum": [
              "servisli",
              "yakin",
              "bes-yildiz",
              "ramazan"
            ]
          },
          "packageTypeLabel": {
            "type": "string"
          },
          "schoolHoliday": {
            "type": "boolean"
          },
          "departureDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Yalnızca departureDateStatus = \"confirmed\" ise dolu."
          },
          "departureDateStatus": {
            "type": "string",
            "enum": [
              "confirmed",
              "to-confirm"
            ]
          },
          "departureDateText": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "const": "USD"
          },
          "sourcePrices": {
            "$ref": "#/components/schemas/Prices"
          },
          "lowestSourcePrice": {
            "type": "number",
            "minimum": 0
          },
          "priceStatus": {
            "type": "string",
            "enum": [
              "source_listed_departure_unspecified"
            ]
          },
          "departureOptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DepartureOption"
            }
          },
          "hotels": {
            "type": "object",
            "required": [
              "category",
              "makkah",
              "madinah",
              "hotelsAreExamples"
            ],
            "additionalProperties": false,
            "properties": {
              "category": {
                "type": "string"
              },
              "makkah": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "madinah": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "hotelsAreExamples": {
                "type": "boolean"
              }
            }
          },
          "nights": {
            "type": "object",
            "required": [
              "makkah",
              "madinah"
            ],
            "additionalProperties": false,
            "properties": {
              "makkah": {
                "type": [
                  "integer",
                  "null"
                ],
                "minimum": 0
              },
              "madinah": {
                "type": [
                  "integer",
                  "null"
                ],
                "minimum": 0
              }
            }
          },
          "itinerary": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "required": [
                  "id",
                  "isSample",
                  "url"
                ],
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "isSample": {
                    "type": "boolean",
                    "const": true
                  },
                  "url": {
                    "type": "string"
                  }
                }
              }
            ]
          },
          "links": {
            "type": "object",
            "required": [
              "page",
              "api"
            ],
            "additionalProperties": false,
            "properties": {
              "page": {
                "type": "string",
                "format": "uri"
              },
              "api": {
                "type": "string"
              }
            }
          },
          "sourceRowNumber": {
            "type": "integer"
          }
        }
      },
      "PackageSummary": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Package"
          }
        ],
        "unevaluatedProperties": false
      },
      "PackageDetail": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Package"
          }
        ],
        "required": [
          "accommodation"
        ],
        "properties": {
          "accommodation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "required": [
                  "label",
                  "makkah",
                  "madinah",
                  "sourceRows"
                ],
                "additionalProperties": false,
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "makkah": {
                    "type": "object",
                    "required": [
                      "hotels",
                      "description"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "hotels": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      }
                    }
                  },
                  "madinah": {
                    "type": "object",
                    "required": [
                      "hotels",
                      "description"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "hotels": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      }
                    }
                  },
                  "sourceRows": {
                    "type": "string"
                  }
                }
              }
            ]
          }
        },
        "unevaluatedProperties": false
      },
      "PackageList": {
        "type": "object",
        "required": [
          "data",
          "pagination",
          "query",
          "notes",
          "excluded",
          "meta"
        ],
        "additionalProperties": false,
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PackageSummary"
            }
          },
          "pagination": {
            "type": "object",
            "required": [
              "total",
              "count",
              "limit",
              "offset",
              "nextOffset"
            ],
            "additionalProperties": false,
            "properties": {
              "total": {
                "type": "integer"
              },
              "count": {
                "type": "integer"
              },
              "limit": {
                "type": "integer"
              },
              "offset": {
                "type": "integer"
              },
              "nextOffset": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "query": {
            "type": "object",
            "description": "Uygulanan (normalleştirilmiş) arama parametreleri.",
            "required": [
              "sort",
              "limit",
              "offset"
            ]
          },
          "notes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Ör. tarihi kesinleşmediği için ay filtresine dahil edilmeyen programlar."
          },
          "excluded": {
            "type": "object",
            "required": [
              "unconfirmedDate",
              "noVerifiedDeparturePrice"
            ],
            "additionalProperties": false,
            "properties": {
              "unconfirmedDate": {
                "type": "integer"
              },
              "noVerifiedDeparturePrice": {
                "type": "integer"
              }
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      },
      "PackageDetailResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PackageDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      },
      "Itinerary": {
        "type": "object",
        "required": [
          "id",
          "title",
          "durationDays",
          "isSample",
          "notice",
          "days",
          "appliesToPackages"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "durationDays": {
            "type": "integer"
          },
          "isSample": {
            "type": "boolean",
            "const": true
          },
          "notice": {
            "type": "string"
          },
          "days": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "day",
                "time",
                "text"
              ],
              "additionalProperties": false,
              "properties": {
                "day": {
                  "type": "integer",
                  "minimum": 1
                },
                "time": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "text": {
                  "type": "string"
                }
              }
            }
          },
          "appliesToPackages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "ItineraryResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "properties": {
          "data": {
            "$ref": "#/components/schemas/Itinerary"
          },
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      },
      "Metadata": {
        "type": "object",
        "required": [
          "brand",
          "season",
          "packageCount",
          "priceCount",
          "currency",
          "durations",
          "packageTypes",
          "roomTypes",
          "departureCities",
          "departureMonths",
          "unconfirmedDateCount",
          "sortOptions",
          "filters",
          "endpoints",
          "site"
        ],
        "additionalProperties": false,
        "properties": {
          "brand": {
            "type": "string"
          },
          "season": {
            "type": "string"
          },
          "packageCount": {
            "type": "integer"
          },
          "priceCount": {
            "type": "integer"
          },
          "currency": {
            "type": "string",
            "const": "USD"
          },
          "durations": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          "packageTypes": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "label"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                }
              }
            }
          },
          "roomTypes": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "label"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                }
              }
            }
          },
          "departureCities": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "city",
                "availabilityStatus",
                "pricesVerified"
              ],
              "properties": {
                "city": {
                  "type": "string"
                },
                "availabilityStatus": {
                  "type": "string"
                },
                "pricesVerified": {
                  "type": "boolean",
                  "const": false
                }
              }
            }
          },
          "departureMonths": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
            }
          },
          "unconfirmedDateCount": {
            "type": "integer"
          },
          "sortOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "filters": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "endpoints": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "site": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "MetadataResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "properties": {
          "data": {
            "$ref": "#/components/schemas/Metadata"
          },
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      }
    }
  }
}
