API от Tutu.ru

Это API мы используем для построения Виджета расписания (в инструментах Tutu.ru) и для Таблиц расписания поездов в нашем WordPress плагине. Мы не рекомендуем использовать данный API для создания поисковых форм, так как данные передаются не в режиме реального времени. 

Запрос

Get https://suggest.travelpayouts.com/search?service=tutu_trains&term=2000000&term2=2064130&callback=n

Параметры запроса

Параметр Тип Описание
term int Код станции отправления
term2 int Код станции прибытия
callback string Параметр для колбек функции

Код станции можно получить здесь https://support.travelpayouts.com/hc/ru/articles/115001440551

Пример ответа

{
  "trips": [
    {
      "name": "Двухэтажный",
      "departureStation": "2000003",
      "arrivalStation": "2064130",
      "runDepartureStation": "2000003",
      "runArrivalStation": "2064150",
      "departureTime": "10:52:00",
      "arrivalTime": "10:14:00",
      "trainNumber": "104В",
      "categories": [
        {
          "type": "coupe",
          "price": 4307
        },
        {
          "type": "lux",
          "price": 14465
        }
      ],
      "travelTimeInSeconds": "84120",
      "firm": true,
      "numberForUrl": "MTA00JI="
    }
  ]
  "url": "/poezda/rasp_d.php?nnst1=2000000&nnst2=2064130"
}

Поля ответа

  • name — название поезда:
    • plazcard — плацкарт;
    • coupe — купе;
    • sedentary — сидячий;
    • lux — люкс;
    • soft — мягкий.
  • departureStation — станция отправления;
  • arrivalStation — станция назначения;
  • runDepartureStation — начальная станция данного поезда;
  • runArrivalStation — конечная станция данного поезда;
  • departureTime — время отправления (московское);
  • arrivalTime — время прибытия (московское);
  • trainNumber — номер поезда;
  • categories — категории вагонов в составе поезда:
    • type — тип;
    • price — цена в рублях.
  • travelTimeInSeconds — время в пути (в секундах);
  • firm — является ли поезд фирменным;
  • url — ссылка на расписание данного поезда на сайте Туту.ру.

Где можно использовать

Для автоматического создания собственных ссылок на расписание поезда или оформление билета на конкретный поезд.

Расписание

В ссылку вида https://www.tutu.ru/poezda/rasp_d.php добавьте параметры:

  • nnst1 — станция отправления;
  • nnst2 — станция назначения;
  • date — дата отправления.

Пример итоговой ссылки: https://www.tutu.ru/poezda/rasp_d.php?nnst1=2006004&nnst2=2004001&date=24.03.2018

Оформление билета

В ссылку вида https://www.tutu.ru/poezda/order/ необходимо передать следующие параметры:

  • dep_st — станция отправления;
  • arr_st — станция назначения;
  • tn — номер поезда (параметр numberForUrl в запросе выше);
  • date — дата заказа.

Итоговая ссылка выглядит так:

https://www.tutu.ru/poezda/order/?dep_st=2006004&arr_st=2004001&tn=MDIw0KM%3D&date=24.12.2018

Не забудьте использовать форму создания партнёрских ссылок! После формы приведённая выше ссылка будет выглядеть так: https://c45.travelpayouts.com/click?shmarker=Маркер&promo_id=1770&source_type=customlink&type=click&custom_url=https%3A%2 °F%2Fwww.tutu.ru%2Fpoezda%2Forder%2 °F%3Fdep_st%3D2006004%26arr_st%3D2004001%26tn%3DMDIw0KM%3D%26date%3D24.12.2018