KazDATA API

Если вы являетесь программным разработчиком и вашей компании необходимо регулярно получать данные из приложения KazDATA для своих процессов и корпоративных систем, то мы можем предоставить вам доступ к приложению по API.

Вот какие данные можно получать по организациям:

• Данные о количестве организаций по отраслям;
• Данные о организациях по регионам;
• Данные об организациях отфильтрованные по местоположению;
• Данные об организациях отфильтрованные по размеру организации;
• Данные об организациях отфильтрованные по типам организаций;
• Данные об организациях отфильтрованные по возрасту;
• Данные об организациях отфильтрованные по видам деятельности;

Представление данных идет в двух форматах:

1. Суммарные данные, для построения диаграмм;
2. Табличные данные. Таблица с детальными данными об организациях которые попадают в фильтр.

Данный API работает с JSON форматом передачи данных. Запросы тоже должны быть переданы в виде JSON объекта.

Доступ к данным можно получить только после авторизации в системе. Авторизация происходит в два этапа:

1. Получение данных о текущей сессии и получении случайной последовательности для шифрования пароля;
2. Предоставление зашифрованных данных авторизации;

Формат ответа от сервера:

{"version":"1.0", "auth":false, "error":0, "errormsg":"OK", "data":{ "salt":"43a1c6a406c25b1160c058aa345f9be4", "sid":"l9fkv9rj7plob0sp84jonccg47" }, "sid":"8nh0amkfeqcb8ekpn5od1cp0q5"}

version - текущая версии API;
auth - авторизован ли клиент в данной сессии;
error - код ошибки, 0 - запрос обработан без ошибок;
errormsg - сообщение ошибки;
data - объект данных, результат запроса;
sid - ID текущей сессии.

Для приведенного примера, первый авторизационный запрос - запрос без параметров:

data.sal - случайная последовательность для кодирования пароля.

Второй запрос на авторизацию должен выглядеть вот так:

{"data":{"mail":"test@test.com", "hash":"695d65d3d475e0c527e879b859e0c9a3"}}

В объекте data находятся данные для обработки. mail - имя входа для авторизации; hash - зашифрованный пароль.

Пример запроса данных в табличном виде:

{"data":{"otype":"type_all","diagram_type":"oked","age":"0","krp":"0", "type_active":"1","kato1":"0",”bin”:”*”,"result_type":"table"}}

Пример ответа (только одна организация):

{"version":"1.0", "auth":true, "error":0, "errormsg":"OK", "data": {"result_type":"table", "page":"0", "page_size":"20", "page_count":"7253", "values": [{"bin":"161240023159", "okpo":"56337013", "name":{"ru":"ТОВАРИЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"TURAN ENERGY\"", "kz":"\"TURAN ENERGY\" ЖАУАПКЕРШІЛІГІ ШЕКТЕУЛІ СЕРІКТЕСТІГІ"}, "oked_name":{"ru":"[35124] Продажа электроэнергии потребителю", "kz":"[35124] Электр энергиясын тұтынушыға сату"}, "kato_name":{"ru":"[711210000] район \"Есиль\"", "kz":"[711210000] ҚАРАҒАНДЫ Қ.Ә.,ҚАРАҒАНДЫ Қ.,ҚАЗЫБЕК БИ АТЫН. А.Ә.,ҚАЗЫБЕК БИ АТЫН.АУДАНЫ"}, "krp_name":{"ru":"[110] Малые предприятия (6 - 10) (от 6 до 10 чел.)", "kz":"[110] Шағын кәсіпорындар (6 - 10) (6 - 10 адам)"}, "begin":"02.01.2017", "reg_date":"27.12.2016"}, …], "labels": {"bin": {"sort":10, "name":{"ru":"БИН"}}, "okpo":{"sort":20, "name":{"ru":"ОКПО"}}, "name":{"sort":30, "name":{"ru":"Наименование"}}, "oked":{"sort":50,"name":{"ru":"ОКЭД"}}, "oked_name":{"sort":60,"name":{"ru":"Вид деятельности предприятия"}}, "kato":{"sort":80, "name":{"ru":"КАТО"}}, "kato_name":{"sort":90, "name":{"ru":"Населённый пункт"}}, "krp":{"sort":110, "name":{"ru":"КРП"}}, "krp_name":{"sort":120,"name":{"ru":"Размер предприятия"}}, "begin":{"sort":140,"name":{"ru":"Добавлено"}}, "reg_date":{"sort":150,"name":{"ru":"reg_date"}}}}, "sid":"vc5si4n89e4pgeq1jolpl4rvp5"}

Детальное описание всех полей и URL для запросов могут быть предоставлены по запросу.

Как подключиться?

Чтобы подключиться к KazDATA по API — свяжитесь с вашим менеджером KazDATA.