KZ Info Service
Описание#
KZ Info - это комплексный сервис, который обеспечивает интеграцию с различными открытыми и закрытыми источниками данных, предоставляя доступ к широкому спектру информации о гражданах Республики Казахстан.
Для комфортной интеграции через Backend API воспользуйтесь Swagger (OpenAPI)
Термины#
- ИИН - индивидуальный идентификационный номер гражданина Республики Казахстан.
- Субъект - это человек, который является объектом запроса на получение информации с открытых источников о нем.
- АИС ОИП - Автоматизированная Информационная Система Оранов Исполнительного производства
Этапы:#
1. Получение API-KEY организации#
Первый этап для использования технологии - получение API-KEY организации. Чтобы получить API-KEY организации, необходимо зайти в Личный Кабинет по данной ссылке. API-KEY находится в поле Backend Api Key
Пример API-KEY организации:
API-KEY: Efy202XKbVAWRu...
Примечание
Для наглядности используется укороченная длина
API KEY. Его фактическая длина составляет 47 и более символов.
2. Отправка запроса на получение информации о наличии в реестре должников через АИС ОИП#
При отправке запроса на получение электронного документа используются данные в формате JSON.
Важно
Чтобы использовать данный сервис, необходимо иметь на него подписку. Подробнее о подписках можно прочитать здесь.
URL запроса:
https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/
| Формат запроса | Метод запроса |
|---|---|
| JSON | POST |
API KEY необходимо передать в теле запроса:
| Наименование поля | Тип | Обязательно | Описание |
|---|---|---|---|
| api_key | String | Да | API KEY организации в личном кабинете |
| iin | String | Да | ИИН субъекта |
Примеры запроса:
import requests
url = 'https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/'
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json',
}
data = {
'api_key': '<organization_api_key>',
'iin': '<subjects_iin>',
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = 'https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/';
const apiKey = '<organization_api_key>';
const headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
};
const data = {
api_key: apiKey,
iin: '<subjects_iin>',
};
fetch(url, {
method: 'POST',
headers: headers,
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
В качестве ответа придет JSON со следующими полями:
- debtor_iin - ИИН должника;
- debtor_surname - Фамилия должника;
- debtor_name - Имя должника;
- debtor_patronymic - Отчество должника;
- debtor_birth_data - Дата рождения должника;
- debtor_doc_number - Номер документа должника;
- issue_organ_code - Код органа, выдавшего документ;
- issue_organ_name_ru - Наименование органа, выдавшего документ (на русском);
- issue_organ_name_kz - Наименование органа, выдавшего документ (на казахском);
- exec_proc_num - Номер исполнительного производства;
- exec_proc_data - Дата исполнительного производства;
- exec_proc_status - Статус исполнительного производства;
- exec_proc_status - Статус исполнительного производства;
- exec_doc_num - Номер документа исполнительного производства;
- exec_doc_issue_date - Дата выдачи документа исполнительного производства;
- essence_requirements_ru - Требования (на русском);
- essence_requirements_kz - Требования (на казахском);
- executor_surname - Фамилия исполнителя;
- executor_name - Имя исполнителя;
- executor_patronymic - Отчество исполнителя;
- executor_contacts - Контактные данные исполнителя;
- executor_address - Адрес исполнителя;
- disa_code - Код подразделения, осуществляющего взыскание;
- to_name_ru - Наименование подразделения, осуществляющего взыскание (на русском);
- to_name_kz - Наименование подразделения, осуществляющего взыскание (на казахском);
- to_address - Адрес подразделения, осуществляющего взыскание (на русском);
- record_id - ИД записи;
- recover_amount - Сумма взыскания;
Пример ответа:
[
{
"debtor_iin": "010203040506",
"debtor_surname": "ФАМИЛИЯ",
"debtor_name": "ИМЯ",
"debtor_patronymic": "ОТЧЕСТВО",
"debtor_birth_data": "1970-01-01+00:00",
"debtor_doc_number": "12345678",
"issue_organ_code": "12345",
"issue_organ_name_ru": "Нотариальная палата по г.Астана",
"issue_organ_name_kz": "Нотариальная палата по г.Астана",
"exec_proc_num": "000/00-00-0000",
"exec_proc_date": "1970-01-01+00:00",
"exec_proc_status": "3",
"exec_doc_num": "12345678",
"exec_doc_issue_date": "1970-01-01+00:00",
"essence_requirements_ru": "Взыскании с --- в пользу --- задолженность в размере 100 тенге",
"essence_requirements_kz": "Взыскании с --- в пользу --- задолженность в размере 100 тенге",
"executor_surname": "ФАМИЛИЯ",
"executor_name": "ИМЯ",
"executor_patronymic": "ОТЧЕСТВО",
"executor_contacts": "+77001234567",
"executor_address": "г. Алматы, --- район, ул. --- д. 0, офис 0.",
"disa_code": "935",
"to_name_ru": "Частные судебные исполнители г.Алматы",
"to_name_kz": "Алматы қаласының жеке сот орындаушылары",
"to_address": "Алматы қ.",
"record_id": "12345678",
"recover_amount": "100.00"
}
]
Ошибки#
| Код состояния | Ответ | Описание |
|---|---|---|
| 400 | Subscription has not started | Подписка еще не активировалась |
| 400 | No active or future subscription for technology | Нет активной или будущей подписки на технологию |
| 400 | Client does not have subscription | У клиента отсутствует подписка, подробнее о подписках можно прочитать здесь |
| 400 | Client does not have access to KZ Info technology | У клиента нет доступа к технологии. Причины: подписка отсутствует, либо она истекла, или технология не активна |
| 404 | Subject not found | Данные по субъекту не найдены |
| 503 | KZ Citizen Info service is not available now | Сервис KZ Citizen Info в данное время не доступен |