{
  "name": "Hickmet",
  "legal_name": "Hickmet Travel",
  "description": "Казахстанский туроператор по Хаджу и Умре, работает с 2008 года. Отели рядом с Харамом в Мекке и Медине, перелёты из городов Казахстана, визовая поддержка, трансферы и сопровождение гидов.",
  "url": "https://hickmet.kz",
  "version": "2026-08-28",
  "languages": [
    "ru",
    "kk",
    "en"
  ],
  "currency": "KZT",
  "contact": {
    "phone": "+77080002211",
    "whatsapp": "https://wa.me/77080002211",
    "email": "ceo@hickmet.kz",
    "address": "ул. Каппарова 378, Алматы, Казахстан",
    "page": "https://hickmet.kz/ru/contact"
  },
  "capabilities": {
    "read": [
      "Найти вылеты по датам, городу отправления и составу группы",
      "Прочитать программу тура, что входит в цену и что нет",
      "Посмотреть отели: расстояние до Харама, рейтинг, удобства",
      "Прочитать каталог магазина для паломников"
    ],
    "write": [],
    "write_note": "Бронирование и оплата доступны только человеку на сайте. Передайте пользователю booking_url — форма откроется с уже заполненными датами и составом группы."
  },
  "discovery": {
    "agents_page": "https://hickmet.kz/agents",
    "openapi": "https://hickmet.kz/openapi.json",
    "llms_txt": "https://hickmet.kz/llms.txt",
    "sitemap": "https://hickmet.kz/sitemap.xml"
  },
  "api": {
    "base_url": "https://hickmet.kz/api/agent",
    "auth": "none",
    "formats": [
      "application/json"
    ],
    "endpoints": [
      {
        "method": "GET",
        "path": "/api/agent/cities",
        "summary": "Города вылета, из которых действительно есть рейсы"
      },
      {
        "method": "GET",
        "path": "/api/agent/tours",
        "summary": "Вылеты с ценой, датами и отелями",
        "query": [
          "departure_city_id",
          "date_from",
          "date_to",
          "adults",
          "teens",
          "children",
          "limit",
          "lang"
        ]
      },
      {
        "method": "GET",
        "path": "/api/agent/tours/{schedule_id}",
        "summary": "Один вылет целиком: программа по дням, что включено, места"
      },
      {
        "method": "GET",
        "path": "/api/agent/hotels",
        "summary": "Отели туров"
      },
      {
        "method": "GET",
        "path": "/api/agent/hotels/{hotel_id}",
        "summary": "Отель: карта, Харам, удобства, оценки"
      },
      {
        "method": "GET",
        "path": "/api/agent/products",
        "summary": "Магазин для паломников"
      }
    ]
  },
  "handoff": {
    "tour_url_template": "https://hickmet.kz/{lang}/tours/{schedule_id}",
    "booking_url_template": "https://hickmet.kz/{lang}/tours/{schedule_id}/bookings?adults={adults}&teens={teens}&children={children}",
    "note": "Адрес тура содержит идентификатор конкретного вылета, а не тура: у одного тура несколько ссылок с разными датами."
  },
  "notes": [
    "Цены в тенге. Цены туров хранятся в долларах и пересчитываются по курсу на момент запроса, поэтому в каждом ответе есть generated_at.",
    "Возраст: adults — от 18, teens — подростки, children — дети. Так же называются параметры в ссылке на бронирование.",
    "available_seats отражает вместимость, а не живой остаток мест: не сообщайте человеку, что вылет распродан, опираясь только на это число.",
    "У отеля две разные оценки: stars — звёздность до пяти, guest_score — оценка гостей с Booking.com из десяти."
  ],
  "policy": {
    "rate_limit": "Разумная нагрузка; ответы кэшируются на 10 минут, чаще опрашивать смысла нет.",
    "attribution": "При пересказе данных давайте ссылку на страницу тура или отеля.",
    "robots": "https://hickmet.kz/robots.txt"
  }
}