API Индекса ATI.SU по направлениям

API предоставляет значение Индекса ATI.SU для 100 самых популярных направлений в РФ, входящих в общий Индекс ATU.SU.

API позволяет запросить значения Индекса ATI.SU:

по 100 самым популярным направлениям в РФ;
для полностью загруженного транспорта 20 т, 82 м3;
за интересующий вас период;
для всех типов кузовов или отдельно для рефрижератора, открытого и закрытого кузова.

Как получить доступ к API

Чтобы получить доступ к API – подключите лицензию «API Средних ставок» на странице оплаты.

Если у вас остались вопросы — напишите в техническую поддержку на api@ati.su.

Методы

Динамика индекса по направлению

post /index/license/v1/index_by_direction

Модель и примеры
Консоль

Запрос

Модель

{...}

DateFrom*: date

Начало периода. Формат ISO-8601.

DateTo*: date

Конец периода. Формат ISO-8601.

From*:{...}

Точка откуда.

Id*: integer

Id точки.

}

To*:{...}

Точка куда.

Id*: integer

Id точки.

}

CarType: string

Тип кузова.

ref – Рефрижераторы
close – Закрытые
open – Открытые
all – Все типы

}

Пример запроса

CURL
1C

curl 'https://api.ati.su/index/license/v1/index_by_direction' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"DateFrom":"2022-02-01","DateTo":"2022-03-02","From":{"Id":0},"To":{"Id":0},"CarType":"ref"}'

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/index/license/v1/index_by_direction", "{""DateFrom"":""2022-02-01"",""DateTo"":""2022-03-02"",""From"":{""Id"":0},""To"":{""Id"":0},""CarType"":""ref""}");

Ответ

200 Successful Response

Модель

{...}

Data*:[{...}]

Набор данных индекса

Date*: date

Дата. Формат ISO-8601

Index*: integer

Значение индекса

}]

}

Пример

{...}

"Data":[...]

{...}

"Date":"1970-01-01",

"Index":0

}

]

}

404 Not Found

Модель

{...}

error_body*: string

основное тело ошибки с описанием

reason*: string

тип ошибки если имеется

status_code*: integer

код возвращаемой ошибки

details*:{}

какие-либо дополнительные детали ошибки

}

Пример

{...}

"error_body":"string",

"reason":"string",

"status_code":0,

"details":{}

}

422 Validation Error

Модель

{...}

detail:[{...}]

loc*:[]

msg*: string

type*: string

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

{...}

"prop1":"string"

}

"msg":"string",

"type":"string"

}

]

}

Доступные направления индекса

get /index/license/v1/directions

Модель и примеры
Консоль

Запрос

Пример запроса

CURL
1C

curl 'https://api.ati.su/index/license/v1/directions' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/index/license/v1/directions");

Ответ

200 Successful Response

Модель

{...}

Directions*:[{...}]

Все направления для индекса

From*:{...}

Точка откуда.

Id*: integer

Id точки.

Name*: string

Название точки.

}

To*:{...}

Точка куда.

Id*: integer

Id точки.

Name*: string

Название точки.

}

}]

}

Пример

{...}

"Directions":[...]

{...}

"From":{...},

"Id":0,

"Name":"string"

"To":{...}

"Id":0,

"Name":"string"

}

]

}