Разделы и статьи

Как работать с запросами к API

Swagger — это набор инструментов, которые помогают описывать API. Чтобы было проще разобраться в работе Partner API, мы разместили спецификацию и примеры в Swagger.

Как сделать запрос к API в Swagger

1. Спецификация доступна по ссылке: https://partner.qatl.ru/docs/booking-process/.

2. Пользовательский веб-интерфейс:

cd31b097b8daf227c35fe214e0f08530.png

 

3. Чтобы выбрать нужное API из раскрывающегося списка, нажмите на стрелочку в верхнем правом углу:

35515b1da6c0a44008de10c5a3322d95.png

 

4. Чтобы начать выполнять запросы, авторизуйтесь с помощью ключа API (APIKey). APIKey вы получите на свою электронную почту.

Ключ API — это уникальный набор символов, который используется для аутентификации запросов. Аутентификация — проверка подлинности данных о пользователе.

5. Если вы переключаетесь между API, введите APIKey заново.

6. Работа с API происходит с помощью отправки GET или POST запросов.

7. При некорректных запросах или проблемах в работе API возвращается информация об ошибках. Список ошибок смотрите в конце статьи.

 

Как авторизоваться

1. Нажмите кнопку «Authorize»:

989abdeec8cf137c97965aa663c79209.png

 

2. Введите полученный APIKey → нажмите кнопку «Authorize»:

7d52ee4714585065c0815d3cf8881d6c.png

 

3. Нажмите кнопку «Close», чтобы закрыть окно авторизации:

0479b002c92f0157f45908685ec0894b.png

 

4. Выполняйте запросы с помощью кодов объектов размещения для тестирования propertyId: 7291, 8155, 8156, 8613, 8614, 8615, 8616, 8617, 8618, 8619, 8726, 8745, 8746.

 

Как сделать запрос к API

Описанная ниже последовательность действий применяется для выполнения запроса любого из методов в описании API.

1. Выберите API:

  • Content API — информация о средствах размещения;

  • Search API — поиск вариантов размещений;

  • Reservation API — работа с бронированиями;

  • Geo API — поиска средств размещений по городу/региону/стране.

2. Выберите запрос, который доступен в выбранном API. Например, «Получить информацию о средствах размещения»:

32ae0bd34f5dfef6ce2e19024b438c90.png

 

3. Нажмите кнопку «Try it out»:

d04a7e4d532e7acb3dd737e5f6a374f0.png

 

4. Введите свои данные:

7841ef8ad0c2dd89d29c1db84e3c6919.png

 

5. Нажмите кнопку «Execute»:

e5db1b61342530c5545879f8a23c79e4.png

 

Важно! Перед тем, как выполнить запрос, обратите внимание на описание к параметрам.

6. Если запрос успешно выполнен, то в ответ вы получите код 200 и детальное описание средств размещений:

2ed20bd0902d8fd3af9cc35d3a5e4154.png

 

7. Если произошла ошибка, то вы получите код ошибки и ее описание. Вот пара примеров:

Код 400 — сервер считает, что вы сделали неверный запрос. Это может произойти, если вы отправили неверные данные:

3bce3eb3266644269bfef130d5fc50de.png

 

В этом примере было превышено допустимое число элементов, которое было введено в поле «count».

Код 401 — сервер считает, что произошла ошибка авторизации. Это может произойти, если вы отправили неверные данные:

e4d5f5d0f3b3463661983620e5300d07.png

 

В этом примере не был введен APIKey.

8. Аналогично выполняются и все остальные запросы к API.

9. Чтобы просмотреть в методе все входящие и исходящие параметры, их типы и описание, нажмите на кнопку «Schema»:

5d19225128318266c3f2e8183167ad09.png


Обратиться в техподдержку TravelLine

Если у вас остались вопросы, вы всегда можете связаться со специалистами технической поддержки.
Позвоните нам по телефону или задайте интересующий вас вопрос прямо сейчас.

Подробнее