Uticket API
Прикладной программный интерфейс для продажи билетов.
Документация

Общие принципы взаимодействия

t2t.api реализовано в виде REST-сервиса размещенного по адресу https://api.t2t.in.ua/ (production) и https://sandbox-api.t2t.in.ua (sandbox). Отличие production от sandbox заключаются в том, что продажи через sandbox являются виртуальными, не дают право на проезд и не создают финансовых обязательств.

Запросы выполняются по протоколу https с иcпользованием методов GET, PUT, POST, DELETE. Для аутентификации клиентских запросов используется протокол “HTTP Basic Authentication”.

Полный перечень запросов приведён в следующей таблице:

Запрос Описание Метод
1 departure_stations Получить список станций, ОТ которых можно продавать билеты, по шаблону и параметрам GET
2 arrive_stations Получить список станций, ДО которых можно продавать билеты, по шаблону и параметрам GET
3 variants Получить спиcок возможностей проезда (рейсов, предложений от авиакомпаний, поездов) GET
4 tu_map Получить карты транспортного средства (поезда, автобуса) GET
5 car_map Получить карту вагона (только для поездов) GET
6 invoice Получить инвойс GET
7 boarding_pass Получить посадочный талон (только для электронных билетов) GET
8 barcode Получить gif изображение штрихкода (только для бланков заказа. GET
9 qrcode Получить gif изображение qr кода (только для эл. билетов) GET
10 invoice_status Получить состояние счёта (оплачен, отменён, билет получен, посадка выполнена и др…) GET
11 transation_info Предварительная информация о транзакции GET
12 bill Выписка счёта POST
13 pay Оплатить транзакцию PUT
14 cancel Отменить транзакцию DELETE
15 account_state Состояние счёта GET
16 registry Реестр выписанных счетов GET
17 stoppoint Список остановочных пунктов по указанному транспорту GET
18 vehicle_schema Схема размещения мест в вагоне (cхема вагона) GET

* Серым выделены запросы которые в данный момент не поддерживаются сервисом.

В соответствии с идеологией REST, запросы информационного характера выполняются методом GET (простым обращением по соответствующему url), запросы свзаные с созданием, модификацией и отменой счетов выполняются методами POST, PUT, DELETE соответственно.

Для получения любых данных и доступа любой функциональности, предоставляемой t2t.api, существует соответствующий URI, который в общем случае имеет вид:

https://$login:$password@api.t2t.in.ua/$method_name/$language_id/$transport_id/$request_specific_argusments

Где:

$login — логин учётной записи от имени которого производится запрос

$password — пароль к учётной записи

$method_name — название запроса который необходимо обработать (см. Табл. 1)

$language_id — идентификатор языка, на котором должен приходить ответ. Возможны такие варианты:

  • ua — украинский
  • ru — русский
  • en — английский

$transport_id — идентификатор транспорта для которого выполняется запрос. Возможны такие варианты:

  • train или rw — поезда
  • bus — автобусы
  • air или plane или avia — самолёты

$request_specific_arguments — остальные параметры специфичные для конкретного запроса

В результате обработки запроса t2t отсылает клиенту данные в виде json сообщения, вид которого специфичен для каждого запроса.

Примеры некоторых запросов к t2t.api:

https://api.t2t.in.ua/departure_stations/ru/bus/10/%D0%A1 — получить список автобусных станций отправления в количестве не более 1-0ти названия которых начинаются «С». Результат отдать на русском языке.

https://api.t2t.in.ua/arrive_stations/ru/bus/10/%D0%A1 — получить список автобусных станций прибытия в количестве не более 10ти названия которых начинаются «С» . Результат отдать на русском языке.

https://api.t2t.in.ua/variants/ru/rw/22200001/22208001/2012-10-16 — получить список вариантов проезда на поезде, от станции 22200001 до станции 22208001 отправлением 2013-03-16.

https://api.t2t.in.ua/variants/ru/air/30005040/30006528/2013-12-20/2013-12-22 — получить список вариантов перелёта от станции 30005040 (Киев) до 30006528 (Одесса) отправлением 2013-12-20 и возвратом 2012-122-22

https://api.t2t.in.ua/variants/ru/air/30005040/30006528/2013-12-20 — получить список вариантов перелёта в один конец от станции 30005040 (Киев) до 30006528 (Одесса) отправлением 2013-12-20