Словари для работы с машинами

Данные, полученные с помощью указанных ниже методов, вы сможете использовать при работе с Машинами.

Каждому варианту кузова, загрузки, оплаты или валюте присвоены свои идентификаторы. Воспользуйтесь словарями из списка ниже, чтобы найти нужные id.

Получение справочника типов кузовов. API для интеграции. Справочник отдаётся целиком: фильтров и постраничной выдачи нет. Кузов указывается в требованиях к транспорту.

get /v1.0/dictionaries/carTypes

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

Параметры

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

Запрос

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

CURL
1C

curl 'https://api.ati.su/v1.0/dictionaries/carTypes' \
  -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", "/v1.0/dictionaries/carTypes");

Ответ

200 Справочник целиком.

Модель

[{...}]

Тип кузова.

Id: int64

Числовой идентификатор записи справочника.

Id2: guid

Идентификатор записи справочника в виде guid.

Name: string

Название записи справочника на русском.

Attribs: int32

Служебная битовая маска свойств кузова

Position: int32

Порядок кузова в списке

TypeId: int32

Порядковый номер кузова в справочнике. В грузах кузов задаётся полем Id — битом маски

StringifiedTypeId: string

Идентификатор кузова строкой

NameEng: string

Название на английском

ShortName: string

Короткое название

ShortNameEng: string

Короткое название на английском

}]

Пример

[...]

{...}

"Id":1,

"Id2":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Name":"Тент.",

"Attribs":4,

"Position":20,

"TypeId":200,

"StringifiedTypeId":"1",

"NameEng":"tent truck",

"ShortName":"тент.",

"ShortNameEng":"tent"

}

]

Получение справочника вариантов загрузки. API для интеграции. Справочник отдаётся целиком: фильтров и постраничной выдачи нет. Вариант загрузки указывается в точке погрузки груза.

get /v1.0/dictionaries/loadingTypes

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

Параметры

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

Запрос

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

CURL
1C

curl 'https://api.ati.su/v1.0/dictionaries/loadingTypes' \
  -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", "/v1.0/dictionaries/loadingTypes");

Ответ

200 Справочник целиком.

Модель

[{...}]

Вариант загрузки или разгрузки.

Id: int64

Числовой идентификатор записи справочника.

Id2: guid

Идентификатор записи справочника в виде guid.

Name: string

Название записи справочника на русском.

NameEng: string

Название на английском

ShortName: string

Короткое название

ShortNameEng: string

Короткое название на английском

}]

Пример

[...]

{...}

"Id":1,

"Id2":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Name":"Тент.",

"NameEng":"rear",

"ShortName":"задн.",

"ShortNameEng":"rear"

}

]

Получение справочника валют. API для интеграции. Справочник отдаётся целиком: фильтров и постраничной выдачи нет. Валюта указывается в ставке груза.

get /v1.0/dictionaries/currencyTypes

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

Параметры

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

Запрос

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

CURL
1C

curl 'https://api.ati.su/v1.0/dictionaries/currencyTypes' \
  -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", "/v1.0/dictionaries/currencyTypes");

Ответ

200 Справочник целиком.

Модель

[{...}]

Валюта в кратком виде.

Name: string

Название валюты на русском

NameEng: string

Название валюты на английском

Id: int64

Идентификатор валюты

Id2: guid

Идентификатор валюты в виде guid

Modifier: int32

Множитель единицы валюты: 1 для РУБ, 1000 для ТЫС.РУБ

CurrencyIdPerKm: int32 (nullable)

Идентификатор этой же валюты в пересчёте за километр: у РУБ это РУБ/КМ

CurrencyIdPerTon: int32 (nullable)

Идентификатор этой же валюты в пересчёте за тонну: у РУБ это РУБ/Т

Iso4217Code: string

Буквенный код валюты по ISO 4217

Iso4217DigitalCode: int32

Числовой код валюты по ISO 4217

}]

Пример

[...]

{...}

"Name":"руб",

"NameEng":"rub",

"Id":1,

"Id2":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Modifier":1,

"CurrencyIdPerKm":8,

"CurrencyIdPerTon":13,

"Iso4217Code":"RUB",

"Iso4217DigitalCode":643

}

]

Получение справочника вариантов оплаты. API для интеграции. Справочник отдаётся целиком: фильтров и постраничной выдачи нет. Вариант оплаты указывается в условиях оплаты груза.

get /v1.0/dictionaries/moneyTypes

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

Параметры

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

Запрос

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

CURL
1C

curl 'https://api.ati.su/v1.0/dictionaries/moneyTypes' \
  -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", "/v1.0/dictionaries/moneyTypes");

Ответ

200 Справочник целиком.

Модель

[{...}]

Вариант оплаты.

Id: int64

Числовой идентификатор записи справочника.

Id2: guid

Идентификатор записи справочника в виде guid.

Name: string

Название записи справочника на русском.

NameEng: string

Название на английском

}]

Пример

[...]

{...}

"Id":1,

"Id2":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Name":"Тент.",

"NameEng":"cash"

}

]

Получение расшифровок причин отказа в доступе к машине. API для интеграции. Ключ — код причины из ошибки доступа к машине, значение — пояснение на русском.

get /v1.0/dictionaries/truck_access_denied_reasons

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

Параметры

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

Запрос

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

CURL
1C

curl 'https://api.ati.su/v1.0/dictionaries/truck_access_denied_reasons' \
  -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", "/v1.0/dictionaries/truck_access_denied_reasons");

Ответ

200 Причины отказа. Ключ — код причины.

Модель

{...}

any-key: string

}

Пример

{...}

"1":"Ваша фирма не имеет доступа к работе с машинами"

}