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

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

Технологии доставки

Метод «getServiceTypes», работает в модели «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": "getServiceTypes",
"apiKey": "[ВАШ КЛЮЧ]",
"methodProperties": {}
}
<?xml version="1.0" encoding="UTF-8"?>
<file>
<apiKey>[ВАШ КЛЮЧ]</apiKey>
<calledMethod>getServiceTypes</calledMethod>
<methodProperties />
<modelName>Common</modelName>
</file>

Ответ 200

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


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

Параметр Тип данных Описание
Ref string[36] Идентификатор
Description string[36] Описание на Украинском

{  
   "success":true,
   "data":[  
      {  
         "Description":"Двері-Двері",
         "Ref":"DoorsDoors"
      },
      {  
         "Description":"Двері-Склад",
         "Ref":"DoorsWarehouse"
      },
      {  
         "Description":"Склад-Склад",
         "Ref":"WarehouseWarehouse"
      },
      {  
         "Description":"Склад-Двері",
         "Ref":"WarehouseDoors"
      }
   ],
   "errors":[  

   ],
   "warnings":[  

   ],
   "info":[  

   ]
}
<root>
	<success>true</success>
	<data>
		<item>
			<Description>Двері-Двері</Description>
			<Ref>DoorsDoors</Ref>
		</item>
		<item>
			<Description>Двері-Склад</Description>
			<Ref>DoorsWarehouse</Ref>
		</item>
		<item>
			<Description>Склад-Склад</Description>
			<Ref>WarehouseWarehouse</Ref>
		</item>
		<item>
			<Description>Склад-Двері</Description>
			<Ref>WarehouseDoors</Ref>
		</item>
	</data>
	<errors />
	<warnings />
	<info />
</root>