Hickmet · для ИИ-агентов
Отправьте своего агента подобрать Умру
Hickmet — казахстанский туроператор по Хаджу и Умре, работает с 2008 года. Эта страница — для программ, а не для людей: здесь адреса машинных данных, схема ответов и правила, которые уберегут от неверного ответа.
Данные доступны только на чтение. Забронировать и оплатить может лишь человек на сайте — агент доводит его до формы, уже заполненной датами и составом группы.
Как это работает
- Шаг 1НайтиСпросите города вылета, затем вылеты по датам и составу группы.
- Шаг 2УточнитьЗаберите программу по дням, что входит в цену, отели и расстояние до Харама.
- Шаг 3ПоказатьНазовите даты, город вылета и цену за человека — и дайте ссылку на тур.
- Шаг 4Передатьbooking_url открывает форму с уже заполненными датами и составом. Дальше — человек.
Точки входа
Данные
Все эндпоинты — GET, без ключей и авторизации, ответ в JSON. Базовый адрес https://hickmet.kz/api/agent. Параметр lang принимает ru, kk и en — он меняет и язык описаний, и локаль в ссылках. Где перевода ещё нет, приходит русский текст.
- GET /api/agent/citiesГорода, из которых действительно есть вылеты.
- GET /api/agent/toursВылеты: даты, город, цена за человека, отели. Фильтры — departure_city_id, date_from, date_to, adults, teens, children.
- GET /api/agent/tours/{schedule_id}Вылет целиком: программа по дням, что входит и что нет, отели, места.
- GET /api/agent/hotelsОтели туров с рейтингом и городом.
- GET /api/agent/hotels/{hotel_id}Отель: координаты, путь до Харама, удобства.
- GET /api/agent/productsМагазин для паломников: ихрам, наборы, аксессуары.
Один запрос
Найти вылеты для двух взрослых и ребёнка в марте:
curl "https://hickmet.kz/api/agent/tours?date_from=2026-03-01&date_to=2026-03-31&adults=2&children=1"В ответе у каждого вылета есть url — страница тура, и booking_url — та же страница сразу на форме бронирования, с проставленными датами и составом группы. Это и есть ссылка, которую стоит отдать человеку.
{
"currency": "KZT",
"generated_at": "2026-08-28T09:00:00.000Z",
"departures": [
{
"id": "8010a68c-…",
"tour": { "name": "Умра в Рамадан", "type": "Умра", "duration_days": 12 },
"departure_city": "Алматы",
"departure_date": "2026-03-14",
"price_from": { "adult": 900000, "teen": 850000, "child": 700000 },
"url": "https://hickmet.kz/ru/tours/8010a68c-…",
"booking_url": "https://hickmet.kz/ru/tours/8010a68c-…/bookings?adults=2&children=1"
}
]
}Что легко понять неправильно
- Адрес тура — это идентификатор вылетаОдин тур продаётся несколькими вылетами, и каждый имеет свой адрес. Две строки с одинаковым названием и разными датами — это норма, а не дубль.
- Цена живёт ровно до следующего запросаЦены туров хранятся в долларах и пересчитываются в тенге по курсу на момент запроса. В каждом ответе есть generated_at — не пересказывайте цену недельной давности.
- available_seats — это вместимостьРезервирование мест пока не доведено до конца, поэтому число показывает ёмкость группы, а не живой остаток. Не говорите человеку, что вылет распродан, опираясь только на него.
- Две разные оценки отеляstars — звёздность, до пяти. guest_score — оценка гостей с Booking.com, из десяти, и приходит только в карточке отеля. Перепутать их — значит назвать пятизвёздочный отель «оценка 5 из 10».
Правила
- Ответы кэшируются на десять минут — опрашивать чаще нет смысла.
- Пересказывая данные, давайте ссылку на страницу тура или отеля.
- Не заполняйте за человека паспортные данные и не пытайтесь оплатить: таких эндпоинтов здесь нет.
- Чего-то не хватает — напишите, добавим: ceo@hickmet.kz.