Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/visavi/rzd-api
Api сайта rzd.ru
https://github.com/visavi/rzd-api
api php rzd rzd-tickets-checker
Last synced: 3 days ago
JSON representation
Api сайта rzd.ru
- Host: GitHub
- URL: https://github.com/visavi/rzd-api
- Owner: visavi
- Created: 2016-03-09T14:50:16.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-12-02T20:22:17.000Z (about 2 months ago)
- Last Synced: 2025-01-07T15:11:53.210Z (10 days ago)
- Topics: api, php, rzd, rzd-tickets-checker
- Language: PHP
- Homepage:
- Size: 468 KB
- Stars: 81
- Watchers: 11
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Api сайта rzd.ru
[](https://packagist.org/packages/visavi/rzd-api)
[](https://packagist.org/packages/visavi/rzd-api)
[](https://packagist.org/packages/visavi/rzd-api)
[](https://packagist.org/packages/visavi/rzd-api)
[Описание установки](https://github.com/visavi/rzd-api/blob/master/docs/install.md)
[Описание интерфейса пользователя](https://github.com/visavi/rzd-api/blob/master/docs/auth.md)
### Что умеет Api
* Получает маршруты в одну точку
* Получает маршруты туда-обратно
* Получает список вагонов выбранного поезда
* Получает список станций в пути следования выбранного маршрута
* Получает список кодов станций (Поиск по первым символам города)
### Демонстрация возможностей
#### Быстрый способ (Docker)
```commandline
docker run -p 8000:8000 --rm --name rzd-api -v $(pwd):/app-it pavelsr/rzd-api
curl -s 'http://127.0.0.1:8000/train_routes.php?code0=2004000&code1=2000000'
```
Если вы предпочитаете Github Container Registry вы можете также использовать образ `ghcr.io/pavelsr/rzd-api:latest`
#### Локальная установка
Скачайте архив, распакуйте и перейдите в директорию
Установите необходимые зависимости
```sh
composer install
```
И запустите встроенный веб-сервер
```sh
php -S localhost:8000 -t examples
```
### Пример запроса
```php
setLanguage('en');
// Set userAgent
$config->setUserAgent('Mozilla/5.0 (iPhone; CPU iPhone OS 12_1_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.0 Mobile/15E148 Safari/604.1');
// Set referer
$config->setReferer('https://ticket.rzd.ru/');
// Enable debug mode
$config->setDebugMode(true);
// Set proxy
$config->setProxy('https://username:[email protected]:10');
// Set timeout
$config->setTimeout(10);
//$config не обязателен
$api = new Rzd\Api($config);
// В примере выполняется поиск маршрута САНКТ-ПЕТЕРБУРГ - МОСКВА (только с билетами) на завтра
$params = [
'dir' => 0, // 0 - только в один конец, 1 - туда-обратно
'tfl' => 3, // 3 - поезда и электрички, 2 - электрички, 1 - поезда
'checkSeats' => 1, // 1 - только с билетами, 0 - все поезда
//'withoutSeats' => 'y', // Если checkSeats = 0, то этот параметр тоже необходим
// Коды станций можно получить отдельным запросом
'code0' => '2004000', // код станции отправления
'code1' => '2000000', // код станции прибытия
'dt0' => 'дата на завтра d.m.Y',
'md' => 0, // 0 - без пересадок, 1 - с пересадками
];
$routes = $api->trainRoutes($params);
```
### Процесс приобретения билетов на сайте pass.rzd.ru разделен на несколько этапов
#### Открытая часть
Выбор маршрута - выбор поезда - выбор вагона
#### Закрытая часть
* Информация о пассажирах - Проверка заказа - Оплата заказа - Подтверждение заказа
### Этапы
* В первом этапе пользователь указывают станцию отправления и станцию прибытия поезда, а также дату желаемой поездки.
В этот момент на сайте pass.rzd.ru происходит отправка ajax-запроса, с которым мы и будем работать, запрос возвращает сформированный JSON пакет с ответом, в нем и находится требуемая нами информация или сообщение об ошибке
* Во втором этапе мы можем выбрать необходимый нам поезд и получить полную информацию о свободных местах
* В третьем этапе необходимо выбрать места и заполнить данные необходимые на оплаты и регистрации на сайте
Допустимые запросы через Curl (POST и GET)
Для обхода защиты сайта необходимо предварительно отправить запрос для получения cookies и номера идентификатора RID (REQUEST_ID)
Вторым запросом подставляем уникальный идентификатор RID и отправляем cookie
### Ответы с сайта
Статус ответа содержится в переменной result
RID - означает что сайт выдал нам уникальный идентификатор и куки
OK - получен полный ответ с запрошенными нами данными
Во всех остальных ответах Error или FAIL означает ошибку получения данных
### Получение cookie
Каждый запрос к сайту должен содержать куки примерного вида:
* lang=ru - текущий язык
* JSESSIONID=0000w74wcMhGMfeoE6ibmsh4i4W:17obq9kpt - уникальный ключ
* AuthFlag=false - авторизован ли пользователь на сайте
## Пример запроса
Все запросы идут на адрес http://pass.rzd.ru/timetable/public/ru?layer_id=подкатегория&ключ=значение
Где подкатегория это
* 5827 - выбор маршрута (Получения списка поездов)
* 5764 - детальная информация выбранному по поезду, список вагонов
* 5804 - просмотр маршрута со всеми остановками (Вроде больше не работает, реализовано по-другому)
### Первый запрос
https://pass.rzd.ru/timetable/public/ru?layer_id=5827&dir=0&tfl=3&checkSeats=1&code0={{code_from}}&dt0={{date}}&code1={{code_to}}&dt1={{date}}
### Второй и следующие запросы
https://pass.rzd.ru/timetable/public/ru?layer_id=5827&rid={{rid}}
Второй запрос выполняется с уже полученным нами уникальным идентификатором который хранит в себе данные предыдущего запроса и куками
Поэтому в целях оптимизации можно не отправлять некоторые параметры указанные нами в первом запросе
## Реализованные запросы
Необходимо реализовать отдачу данных через ajax-запросы, в текущих примерах это не реализовано
### trainRoutes - получает маршруты поездов, количество свободных мест, цены итд в нем в один конец
Принимает параметры
обязательные параметр при первом запросе
* layer_id - подкатегория (5827)
Необязательные параметр при повторном запросе
* dir - 0 - только в один конец, 1 - туда-обратно
* tfl - 3 - поезда и электрички, 2 - электрички, 1 - поезда
* checkSeats - 0, 1 - поиск в поездах только если есть свободные места
* code0 - код станции отправления
* code1 - код станции прибытия
* dt0 - дата отправления
* md - маршруты с пересадками (1 - с пересадками, 0 - только прямые рейсы)
Возвращает массив поездов и свободных мест
* from - название станции отправления (САНКТ-ПЕТЕРБУРГ)
* where - название станции прибытия (КИРОВ ПАСС)
* date - дата отправления (27.03.2016)
* fromCode - код станции отправления (2004000)
* whereCode - код станции прибытия (2060600)
Массив поездов содержит
* date0 - дата отправления
* date1 - дата прибытия
* time0 - время отправления
* time1 - время прибытия
* route0 - код станции отправления С-ПЕТ-ЛАД
* route1 - код станции прибытия ТЮМЕНЬ
* number - номер поезда
* timeInWay - время в пути
* brand - Название поезда (Демидовский экспресс)
* carrier - тип поезда ФПК (Фирменный)
* cars - массив свободных мест купе, плацкарт и люкс
* cars.freeSeats - кол. свободных мест
* cars.itype
* cars.servCls - класс обслуживания (2Ю, 2Ж и т.д.)
* cars.tariff - стоимость билета
* cars.pt - баллы
* cars.typeLoc - полное наименование (Плацкартный, СВ, Купе, Люкс)
* cars.type - сокращенное наименование (Купе, плац, люкс)
* cars.disabledPerson - флаг обозначающий места для инвалидов
### trainRoutesReturn - получает маршруты поездов, количество свободных мест, цены итд, туда-обратно
Принимает параметры
обязательные параметр при первом запросе
* layer_id - подкатегория (5827)
Необязательные параметр при повторном запросе
* dir - 0 только в один конец, 1 - туда-обратно
* tfl - тип поезда (3 - поезда и электрички, 2 - электрички, 1 - поезда)
* checkSeats поиск только с билетами (1 - с билетами, 0 - все поезда)
* code0 - код станции отправления
* code1 - код станции прибытия
* dt0 - дата отправления
* dt1 - дата возвращения
Ответы точно такие же как и в методе trainRoutes, только содержит 2 массива, в первом - туда, во-втором - обратно
### trainCarriages - получает список вагонов, свободные места, схема вагона, стоимость билетов, тип и класс обслуживания
Необязательные параметр при повторном запросе
* dir - 0 только в один конец, 1 - туда-обратно
* code0 - код станции отправления
* code1 - код станции прибытия
* dt0 - дата отправления (28.03.2016)
* time0 - время отправления (15:30)
* tnum0 - номер поезда (072Е)
Возвращает следующий массив вагонов
* Стандартный ответ из запросов выше
* cnumber - номер вагона
* type - тип вагона
* typeLoc - полное наименование (Плацкартный, СВ, Купе, Люкс)
* clsType - 2Л, 2Э
* tariff - стоимость билета
* tariffServ - сервис сбор
* seats - массив мест (верхние, верхние боковые, нижние, нижние боковые итд)
* seats.*.places - список свободных мест
* seats.*.tariff - цены за место
* seats.type - сокр. наименование мест (up)
* seats.free - количество мест
* seats.label - полное наименование мест (Верхние)
* schemes схемы вагонов
* html - json массив информация о схеме вагонов
* image - ссылка на картинку
* insuranceCompany - массив с компаниями страхователями и правилами страхования
* shortName - наименование организации
* offerUrl - ссылка на файл с правилами, обычно PDF файл
### trainStationList - получение списка всех станций в текущем маршруте движения
Пример запроса https://pass.rzd.ru/ticket/services/route/basicRoute?STRUCTURE_ID=704&trainNumber=054Г&depDate=13.03.2016
Принимает параметры
Необязательные параметр при повторном запросе
* trainNumber - номер поезда 054Г
* depDate - дата отправления 13.03.2016
Возвращает следующий массив станций
* Station - название станции
* Code - код станции
* ArvTime - время прибытия
* WaitingTime - время стоянки
* DepTime - время отправления
* Distance - пройденная дистанция
### stationCode - Получение списка кодов станций
Принимает параметры
* stationNamePart - часть названия станции, минимум 2 символа
* compactMode - по умолчанию 'y'
Возвращает массив найденных данных
* station - имя станции
* code - код станции
К примеру при значении stationNamePart = 'ЧЕБ' будут возващены все станции начинающиеся на ЧЕБ (11 станций)
### License
The class is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)