JSON-API сервиса поиска вагонов: различия между версиями

Материал из Alta-Soft Wikipedia
Перейти к навигации Перейти к поиску
(Новая страница: «==О сервисе== JSON-API сервиса «Поиск вагонов» позволяет интегрировать возможности сервиса в…»)
 
Строка 3: Строка 3:
 
Посредством данного API можно выполнять оперативные запросы на поиск вагонов и контейнеров по жд сетям, ставить и снимать вагоны и контейнеры на слежение по СНГ, странам Балтии, Монголии и Китаю, а также запрашивать справки ГВЦ.
 
Посредством данного API можно выполнять оперативные запросы на поиск вагонов и контейнеров по жд сетям, ставить и снимать вагоны и контейнеры на слежение по СНГ, странам Балтии, Монголии и Китаю, а также запрашивать справки ГВЦ.
 
Сам интерфейс предоставляется бесплатно, тарифицируются только запросы, выполненные с его помощью согласно расценкам, опубликованным на сайте "Альта-Софт".
 
Сам интерфейс предоставляется бесплатно, тарифицируются только запросы, выполненные с его помощью согласно расценкам, опубликованным на сайте "Альта-Софт".
 +
 +
==API==
 +
Доступ к API предоставляется по URL https://www.alta.ru/rail_tracking/api_v2.php.  Входные параметры передаются с помощью запроса HTTP GET или POST. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.
 +
 +
'''Для авторизации''' необходимо в любой запрос добавить логин в открытом виде, сервис-аккаунт (номер договора для тарификации) и MD5-хеш от сгенерированной строки '''символьное обозначения сервиса + сервис-аккаунт + пароль''', разделенный знаком двоеточия «:».<br>
 +
Например, для пользователя с логином alta@alta.ru, сервис-аккаунтом sa000000 и паролем alta_test:<br>
 +
Вычисляем секрет: secret = md5("rail_tracking:sa000000:md5(alta_test)")<br>
 +
 +
Ниже приводится полный список входных параметров:

Версия 20:44, 26 июля 2021

О сервисе

JSON-API сервиса «Поиск вагонов» позволяет интегрировать возможности сервиса в сторонние программы и сайты. Посредством данного API можно выполнять оперативные запросы на поиск вагонов и контейнеров по жд сетям, ставить и снимать вагоны и контейнеры на слежение по СНГ, странам Балтии, Монголии и Китаю, а также запрашивать справки ГВЦ. Сам интерфейс предоставляется бесплатно, тарифицируются только запросы, выполненные с его помощью согласно расценкам, опубликованным на сайте "Альта-Софт".

API

Доступ к API предоставляется по URL https://www.alta.ru/rail_tracking/api_v2.php. Входные параметры передаются с помощью запроса HTTP GET или POST. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.

Для авторизации необходимо в любой запрос добавить логин в открытом виде, сервис-аккаунт (номер договора для тарификации) и MD5-хеш от сгенерированной строки символьное обозначения сервиса + сервис-аккаунт + пароль, разделенный знаком двоеточия «:».
Например, для пользователя с логином alta@alta.ru, сервис-аккаунтом sa000000 и паролем alta_test:
Вычисляем секрет: secret = md5("rail_tracking:sa000000:md5(alta_test)")

Ниже приводится полный список входных параметров: