API Справочники

Работа со справочниками.

Виды шин и дисков

Метод «getTiresWheelsList», работает в модели «Common», этот метод позволяет загрузить список шин и дисков (используется, если вид груза «шины-диски») на Украинском и Русском языках. Необходимо сохранять копию справочников на стороне клиента и поддерживать ее в актуальном состоянии. Рекомендуется проводить обновление справочников раз в месяц.

URL для входа https://api.novaposhta.ua/v2.0/{format}/ [json or xml]
Формат, обязательно, должен указываться нижним регистром (маленькими буквами), например https://api.novaposhta.ua/v2.0/json/


Доступность: Требует использования API-ключа.

Try it

URL-адрес запроса

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

string

Форматы JSON, XML

(дополнительный)
string

Точка входа для сервисов в формате JSON с форматом ответа JSONP ?callback=?

Заголовки запросов

(дополнительный)
string
Тип формата текста, отправляемого в API.

Текст запроса

Параметр Тип данных Описание
apiKey* string[36] Ваш ключ API 2.0
modelName* string Имя модели
calledMethod* string Имя вызываемого метода
methodProperties string Свойства метода
* Обозначение обязательного параметра

{
"modelName": "Common",
"calledMethod": "getTiresWheelsList",
"apiKey": "[ВАШ КЛЮЧ]"
}
<?xml version="1.0" encoding="utf-8"?>
<file>
<apiKey>[ВАШ КЛЮЧ]</apiKey>
 <modelName>Common</modelName>
 <calledMethod>getTiresWheelsList</calledMethod>
</file>

Ответ 200

Всегда возвращает код 200 даже при логических ошибках.


Тело ответа на запрос

Параметр Тип данных Описание
Ref string[36] Идентификатор
Description string[36] Описание на Украинском
DescriptionRu string[36] Описание на Русском
Weight int[36] Вес
DescriptionType string[36] Описание типа позиции

Дополнительные справочники

Идентификатор Наименование Вес
20f7b625-9add-11e3-b441-0050568002cf Шина вантажна R 22,5 94.00
20f7b626-9add-11e3-b441-0050568002cf Шина вантажна R 17,5 35.00
20f7b627-9add-11e3-b441-0050568002cf Шина вантажна R 19,5 61.00
20f7b628-9add-11e3-b441-0050568002cf Шина вантажна R 20 105.00
d7c456c5-aa8b-11e3-9fa0-0050568002cf Шина легкова R 13-14 14.90
d7c456c6-aa8b-11e3-9fa0-0050568002cf Шина легкова R 15-17 23.09
d7c456c7-aa8b-11e3-9fa0-0050568002cf Шина легкова R 18-19 29.48
d7c456c8-aa8b-11e3-9fa0-0050568002cf Шина легкова R 20-21 34.77
d7c456c9-aa8b-11e3-9fa0-0050568002cf Шина легкова R 23 43.32
d7c456ca-aa8b-11e3-9fa0-0050568002cf Диск вантажний R 17,5 28.00
d7c456cb-aa8b-11e3-9fa0-0050568002cf Диск вантажний R 19,5 45.00
d7c456cc-aa8b-11e3-9fa0-0050568002cf Диск вантажний R 20 80.00
d7c456cd-aa8b-11e3-9fa0-0050568002cf Диск вантажний R 22,5 70.00
d7c456cf-aa8b-11e3-9fa0-0050568002cf Диск легковий R 13-14 14.90
d7c456d0-aa8b-11e3-9fa0-0050568002cf Диск легковий R 15-17 8.75
d7c456d1-aa8b-11e3-9fa0-0050568002cf Диск легковий R 18-19 23.75
d7c456d2-aa8b-11e3-9fa0-0050568002cf Диск легковий R 20-21 40.00
d7c456d3-aa8b-11e3-9fa0-0050568002cf Диск легковий R 23 52.50

{
    "success": true,
    "data": [
        {
            "Ref": "20f7b625-9add-11e3-b441-0050568002cf",
            "Description": "Шина вантажна R 22,5",
            "DescriptionRu": "Шина грузовая R 22,5",
            "Weight": "94.00",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "20f7b626-9add-11e3-b441-0050568002cf",
            "Description": "Шина вантажна R 17,5 ",
            "DescriptionRu": "Шина грузовая R 17,5",
            "Weight": "35.00",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "20f7b627-9add-11e3-b441-0050568002cf",
            "Description": "Шина вантажна R 19,5",
            "DescriptionRu": "Шина грузовая R 19,5",
            "Weight": "61.00",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "20f7b628-9add-11e3-b441-0050568002cf",
            "Description": "Шина вантажна R 20",
            "DescriptionRu": "Шина грузовая R 20",
            "Weight": "105.00",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "d7c456c5-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Шина легкова R 13-14",
            "DescriptionRu": "Шина легковая R 13-14",
            "Weight": "14.90",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "d7c456c6-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Шина легкова R 15-17",
            "DescriptionRu": "Шина легковая R 15-17",
            "Weight": "23.09",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "d7c456c7-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Шина легкова R 18-19",
            "DescriptionRu": "Шина легковая R 18-19",
            "Weight": "29.48",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "d7c456c8-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Шина легкова R 20-21",
            "DescriptionRu": "Шина легковая R 20-21",
            "Weight": "34.77",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "d7c456c9-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Шина легкова R 23",
            "DescriptionRu": "Шина легковая R 23",
            "Weight": "43.32",
            "DescriptionType": "Tires"
        },
        {
            "Ref": "d7c456ca-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск вантажний R 17,5 ",
            "DescriptionRu": "Диск грузовой R 17,5",
            "Weight": "28.00",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456cb-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск вантажний R 19,5",
            "DescriptionRu": "Диск грузовой R 19,5",
            "Weight": "45.00",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456cc-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск вантажний R 20",
            "DescriptionRu": "Диск грузовой R 20",
            "Weight": "80.00",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456cd-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск вантажний R 22,5",
            "DescriptionRu": "Диск грузовой R 22,5",
            "Weight": "70.00",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456cf-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск легковий R 13-14",
            "DescriptionRu": "Диск легковой R 13-14",
            "Weight": "8.75",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456d0-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск легковий R 15-17",
            "DescriptionRu": "Диск легковой R 15-17",
            "Weight": "15.42",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456d1-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск легковий R 18-19",
            "DescriptionRu": "Диск легковой R 18-19",
            "Weight": "23.75",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456d2-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск легковий R 20-21",
            "DescriptionRu": "Диск легковой R 20-21",
            "Weight": "40.00",
            "DescriptionType": "Wheels"
        },
        {
            "Ref": "d7c456d3-aa8b-11e3-9fa0-0050568002cf",
            "Description": "Диск легковий R 23",
            "DescriptionRu": "Диск легковой R 23",
            "Weight": "52.50",
            "DescriptionType": "Wheels"
        }
    ],
    "errors": [],
    "warnings": [],
    "info": []
}
<root>
	<success>true</success>
	<data>
		<item>
			<Ref>20f7b625-9add-11e3-b441-0050568002cf</Ref>
			<Description>Шина вантажна R 22,5</Description>
			<DescriptionRu>Шина грузовая R 22,5</DescriptionRu>
			<Weight>94.00</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>20f7b626-9add-11e3-b441-0050568002cf</Ref>
			<Description>Шина вантажна R 17,5 </Description>
			<DescriptionRu>Шина грузовая R 17,5</DescriptionRu>
			<Weight>35.00</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>20f7b627-9add-11e3-b441-0050568002cf</Ref>
			<Description>Шина вантажна R 19,5</Description>
			<DescriptionRu>Шина грузовая R 19,5</DescriptionRu>
			<Weight>61.00</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>20f7b628-9add-11e3-b441-0050568002cf</Ref>
			<Description>Шина вантажна R 20</Description>
			<DescriptionRu>Шина грузовая R 20</DescriptionRu>
			<Weight>105.00</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>d7c456c5-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Шина легкова R 13-14</Description>
			<DescriptionRu>Шина легковая R 13-14</DescriptionRu>
			<Weight>14.90</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>d7c456c6-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Шина легкова R 15-17</Description>
			<DescriptionRu>Шина легковая R 15-17</DescriptionRu>
			<Weight>23.09</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>d7c456c7-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Шина легкова R 18-19</Description>
			<DescriptionRu>Шина легковая R 18-19</DescriptionRu>
			<Weight>29.48</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>d7c456c8-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Шина легкова R 20-21</Description>
			<DescriptionRu>Шина легковая R 20-21</DescriptionRu>
			<Weight>34.77</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>d7c456c9-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Шина легкова R 23</Description>
			<DescriptionRu>Шина легковая R 23</DescriptionRu>
			<Weight>43.32</Weight>
			<DescriptionType>Tires</DescriptionType>
		</item>
		<item>
			<Ref>d7c456ca-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск вантажний R 17,5 </Description>
			<DescriptionRu>Диск грузовой R 17,5</DescriptionRu>
			<Weight>28.00</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456cb-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск вантажний R 19,5</Description>
			<DescriptionRu>Диск грузовой R 19,5</DescriptionRu>
			<Weight>45.00</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456cc-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск вантажний R 20</Description>
			<DescriptionRu>Диск грузовой R 20</DescriptionRu>
			<Weight>80.00</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456cd-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск вантажний R 22,5</Description>
			<DescriptionRu>Диск грузовой R 22,5</DescriptionRu>
			<Weight>70.00</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456cf-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск легковий R 13-14</Description>
			<DescriptionRu>Диск легковой R 13-14</DescriptionRu>
			<Weight>8.75</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456d0-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск легковий R 15-17</Description>
			<DescriptionRu>Диск легковой R 15-17</DescriptionRu>
			<Weight>15.42</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456d1-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск легковий R 18-19</Description>
			<DescriptionRu>Диск легковой R 18-19</DescriptionRu>
			<Weight>23.75</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456d2-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск легковий R 20-21</Description>
			<DescriptionRu>Диск легковой R 20-21</DescriptionRu>
			<Weight>40.00</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
		<item>
			<Ref>d7c456d3-aa8b-11e3-9fa0-0050568002cf</Ref>
			<Description>Диск легковий R 23</Description>
			<DescriptionRu>Диск легковой R 23</DescriptionRu>
			<Weight>52.50</Weight>
			<DescriptionType>Wheels</DescriptionType>
		</item>
	</data>
	<errors />
	<warnings />
	<info />
</root>