Оглавление:
Введение #
Postman — популярный бесплатный инструмент для тестирования API. Для удобства работы с Sabre APIs все примеры из данных рекомендаций доступны в виде коллекции Postman.
Загрузка #
Для начала работы необходимо загрузить:
- коллекция Postman с примерами из данных рекомендаций
- среда для отправки запросов в тестовой (CERT) среде
- среда для отправки запросов в боевой (PROD) среде
Установка #
Для начала работы необходимо загрузить все файлы и импортировать их в Postman, воспользовавшись кнопкой Import в левом верхнем углу программы. После этого необходимо выбрать каждую из сред в выпадающем меню в правом верхнем углу и установить для них значения следующих переменных:
username
— логин для учетной записи. Используется для создания сессий и токенов доступа. Например,123456
password
— пароль для учетной записи. Используется для создания сессий и токенов доступа. Например,PASSWORD
pcc
— iPCC, в котором будут создаваться сессии и токены доступа, а также производиться поиск. Например,ABCD
pcc_tkt
— PCC, в котором будут создаваться бронирования и оформляться билеты. Он может совпадать с iPCC. Например,EFGH
country_code
— код стока, который будет использован для оформления билетов. Например,RU
ptrta
— терминальный адрес принтера, который будет использован для оформления билетов. Например,123ABC
Использование #
После установки значений переменных в средах можно приступать к отправке запросов. Структура директорий в коллекции Postman повторяет структуру разделов данных рекомендациях. Начать работу с коллекцией можно с создания сессии (Рекомендации по работе с Sabre APIs → Введение → Аутентификация → Создание сессии (SessionCreateRQ)) или токена доступа (Рекомендации по работе с Sabre APIs → Введение → Аутентификация → Создание токена доступа (TokenCreateRQ)).
Для большинства операций с бронированиями и билетами можно создавать бронирования и оформлять из соответствующих разделов. Для процесса возврата билетов предусмотрены специальные запросы для создания бронирований для примеров. Директории с этими запросами и имена запросов начинаются с символа нижнего подчеркивания (_
).
Скрипты и специальные переменные #
Для удобства работы в Postman в коллекции используются скрипты, которые автоматически устанавливают значения специальных переменных:
- переменная
timestamp
— текущее время. Автоматически устанавливается перед отправкой каждого запроса. Используется в заголовках сообщений - переменная
token
— идентификатор сессии или токена доступа. Устанавливается после выполнения запроса создания сессии или токена доступа. Используется в заголовках всех сообщений - переменная
pnr
— код бронирования (PNR Record Locator). Устанавливается после выполнения запросов к сервисам CreatePassengerNameRecordRQ, PassengerDetailsRQ и EnhancedEndTransactionRQ. Используется в запросах к сервисам, в которых необходимо указывать код бронирования - переменная
tkt
— номер билета. Устанавливается после выполнения запроса к сервису AirTicketRQ. В случае оформления нескольких билетов одновременно создаются дополнительные переменныеtkt2
,tkt3
и т.д. Используется в запросах к сервисам, в которых необходимо указывать номер билета. - переменная
tkt_date
— дата оформления билета. Устанавливается после выполнения запроса к сервису AirTicketRQ. В случае оформления нескольких билетов одновременно создаются дополнительные переменныеtkt2_date
,tkt3_date
и т.д. Используется в запросах к сервисам, в которых необходимо указывать дату оформления билета.