Описание REST сервисов АО Казпочта

АО Казпочта, предоставляет сторонним клиентам подключатся через REST API сервис.
По всем вопросам необходимо обратиться по почтовому адресу : postcode@kazpost.kz

На данный момент доступны следуюшие сервисы :

Сервис - Типы объектов
Сервис - Список объектов
Сервис - Список строений
Сервис - Поиск по адресу
Сервис - Поиск по почтовому индексу
Сервис - Поиск строений по почтовому (цифровому) индексу отделения

Сервис - Типы объектов

Предоставляет Список типов объектов и строений

URL сервиса

https://api.post.kz/api/types Пример : https://api.post.kz/api/types

				{
					"total" : "100"
					"data" : [
						{
							'id':'asdf',
							'nameRus':'asdf',
							'nameKaz':'asdf'
						},
						....
						{
							'id':'asdf',
							'nameRus':'asdf',
							'nameKaz':'asdf'
						}
					]

Сервис - Поиск объектов

Cписок объектов по родителю

URL сервиса

https://api.post.kz/api/objects/{parent}?from={from}

Пример : https://api.post.kz/api/objects/A1?from=0
Параметры :

{parent} - Идентификатор родителя

{from} - Начальная позиция для выдачи результатов, не более 100 результатов в ответе

Сервис - Поиск строений

Cписок строений по родителю

URL сервиса

https://api.post.kz/api/buildings/{parent}?from={from}

Пример : https://api.post.kz/api/buildings/G195112?from=0
Параметры :

{parent} - Идентификатор родителя

{from} - Начальная позиция для выдачи результатов, не более 100 результатов в ответе

Сервис - Поиск по адресу

Cписок строений по адресу

URL сервиса

https://api.post.kz/api/byAddress/{address}?from={from}

Пример : https://api.post.kz/api/byAddress/астана кунаева 8?from=0
Example : https://api.post.kz/api/byAddress/astana kunaeva dom 8?from=0
Параметры :

{address} - Строка для поиска

{from} - Начальная позиция для выдачи результатов, не более 100 результатов в ответе

- Дополнительная возможность поиска на латинице

Сервис - Поиск по почтовому индексу

Cписок строений по указанному префиксу

URL сервиса

https://api.post.kz/api/byPostcode/{postcode}?from={from}

Пример : https://api.post.kz/api/byPostcode/Z00T0B8?from=0
Параметры :

{postcode} - Почтовый индекс

{from} - Начальная позиция для выдачи результатов, не более 100 результатов в ответе

Сервис - Поиск строений по почтовому (цифровому) индексу отделения

Список строений по указанному префиксу

URL service

http://api.postcode.kz/api/byOldPostcode/{oldPostcode}?from={from}

Пример : https://api.post.kz/api/byOldPostcode/160000?from=100
Параметры :

{oldPostcode} - Цифровой почтовый индекс

{from} - Начальная позиция для выдачи результатов, не более 100 результатов в ответе

QR code

Download Loading

Сервис - Поиск (выгрузка) по региону (фиксированное количество столбцов)

Список строений с указанием нового индекса строения, адреса строения (фиксированное количество столбцов) и цифрового индекса почтового отделения по указанному буквенному коду региона

URL сервиса

https://api.post.kz/api/byRegion/fixed/{region}

Пример: https://api.post.kz/api/byRegion/fixed/Z
Параметры :

{region} - Буквенный код региона

Регионы Казахстана и соответствующие буквенные обозначения: г.Астана - Z, г.Алматы - A, Акмолинская - C, Алматинская - B, Актюбинская - D, Атырауская - E, Восточно-Казахстанская - F, Жамбылская - H, Западно-Казахстанская - L, Карагандинская - M, Кызылординская - N, Костанайская - P, Мангистауская - R, Павлодарская - S, Северо-Казахстанская - T, Южно-Казахстанская - X.
Для просмотра сгенерированных файлов рекомендуем использовать ПО - LibreOffice, либо открывать в блокноте и пересохранять файл в кодировке UTF-8. MS Excel не всегда распознает .csv с кодировкой

Инструкция для скачивания новых почтовых индексов и адресных данных с https://api.post.kz/

Для скачивания новых почтовых индексов и адресных данных городов/областей необходимо после последнего символа «/» вместо буквенного обозначения «Z» указать буквенное обозначение искомого города/области согласно Таблицы 1. Таблица 1.

Символ	Регион
Z	г.Нур-Султан
A	г.Алматы
C	Акмолинская область
D	Актюбинская область
B	Алматинская область
E	Атырауская область
L	Западно-Казахстанская область
H	Жамбылская область
M	Карагандинская область
P	Костанайская область
N	Кызылординская область
R	Мангистауская область
X	Туркестанская область
S	Павлодарская область
T	Северо-Казахстанская область
F	Восточно-Казахстанская область
Y	г.Шымкент

После скачивания, необходимо в excel формате произвести конвертацию данных. Конвертация производится следующим образом:

Скачивается файл, сохраняется на рабочем столе или в папке;
Создается чистый файл excel формате, нажимаем вкладку «Данные»;

После жмем вкладку «Из текста»

Выбираем скаченный файл

Выбираем с разделителями и жмем далее

После выбираем пункт точка с запятой и жмем далее

В самом конце жмем «Готово» и файл будет нужного формата.

_{Примечание* - Данный материал находится на стадии разработки. Для удобного просмотра ответа JSON, рекомендуем использовать - http://codebeautify.org/jsonviewer}