- Потрібно отримати ключ API розробника для тестування. Нехай це буде — API_KEY
- Якщо у вашій системі вже є встановлене поле ІПН - отримайте дані про фоп за допомогою функції /fop (code) — https://opendatabot.com/api/v2/fop/1111111111?apiKey=API_KEY
- Далі з /fop (code) ми отримуємо правильне ПІБ українською мовою — "full_name": "Матящук Микола Олександрович"
- Далі з /fop (code) беремо "full_name": "Матящук Микола Олександрович" і через функцію / person отримуємо дані про суди, аліменти, розшук —
https://opendatabot.com/api/v2/person?apiKey=API_KEY&pib=Матящук Микола Олександрович®ion_id=3
Додатковий ідентифікатор для судів - регіон (людина судиться там, де прописана), для розшуку - дата народження.
Коди регіонів
- Через / penalties / {code} по ІПН отримуємо усі виконавчі провадження, де людина боржник — https://opendatabot.com/api/v2/penalties/ХХХХХХХХХХ?apiKey=API_KEY
Этап онбордінга
Якщо немає ІПН, точка входу - ПІБ
- Через функцію / person по ПІБ отримуємо дані про суди, аліменти, розшук —
https://opendatabot.com/api/v2/person?apiKey=t5MfhcqZpDYK-70722-8076a9c98c85a03cba8634e7744777c5&pib=Матящук Микола Олександрович®ion_id=3
Додатковий ідентифікатор для судів - регіон (людина зазвичай судять там, де прописана), для розшуку - дата народження.
Якщо база ведеться російською мовою, поле ПІБ має бути редагований для введення ПІБ українською мовою. Рекомендуємо також показати повідомлення "Щоб перевірити людину, введіть ПІБ українською"
- Далі по ПІБ та даті народження отримуємо виконавчі провадження (борги)—
https://opendatabot.com/api/v2/penalties?apiKey=API_KEY&first_name=Віктор&last_name=Янукович&middle_name=Федорович&birth_date=1950-07-09
Этап оффера
Просимо ІПН для перевірки даних про фоп, а також подальшого моніторингу
- Перевірте дані про фоп
Отримайте дані про фоп за допомогою функції / fop (code) — https://opendatabot.com/api/v2/fop/1111111111?apiKey=API_KEY
- Поставте фоп на моніторинг за допомогою / subscriptions — пример подписки по ИНН
Опендатабот буде повідомляти його про такі зміни:
- Зміна статусу фоп, виду діяльності, ПІБ, адреси