Открытый API
Чтобы воспользоваться API нашего реестра реестров, просто добавьте параметр format=json
к адресу страницы с результатами поиска, например, так:
https://open-base.org/search?q=услуги&clearall=on&datasources=registry_andoz_tj&datasources=gr5_gosreestr_kz&datasources=opi_dfo_kz&datasources=data_egov_kz_gbd_ul&datasources=egsu_energo_gov_kz_1_5&datasources=egsu_energo_gov_kz_2_3&datasources=egsu_energo_gov_kz_3_2&datasources=egsu_energo_gov_kz_quasi_fiscal&datasources=goszakup_gov_kz_subject&datasources=goszakup_gov_kz_rnu&datasources=goszakup_gov_kz_contract&format=json
Таким образом вы получите те же самые результаты, но в формате машиночитаемых данных. Документ с результатами состоит из следующих разделов
- search_results — найденные документы и информация о текущей странице
- query — ваш запрос к системе
- search_type — режим поиска (
strict
— полное совпадение,loose
— неполное совпадение) - strict_count — количество результатов в режиме полного совпадения
- loose_count — количество результатов в режиме неполного совпадения
- base_count — количество результатов в текущем режиме поиска
- enabled_datasources — источники, по которым проводится поиск
- datasources — дополнительная информация по источникам поиска, включая название на русском
Содержимое search_results
состоит из следующих полей
- paginator — информация про текущую страниц и разбивку на страницы, где
count
— общее количество результатов,num_pages
— количество страниц,per_page
— количество результатов на страницу - number — номер текущей страницы
- object_list — собственно, результаты поиска
Разумеется, что документы из разных источников поиска (например, тендеры и реестр компаний) будут иметь разную структуру, но некоторые поля будут общими для всех источников:
- id — уникальный идентификатор документа
- source — датасет-источник (используйте поле
datasources
чтобы получить больше информации про датасет) - last_updated_from_dataset — последняя дата, когда мы нашли эту запись в оригинальном датасете (может отсутствовать)
- first_updated_from_dataset — первая дата, когда мы нашли эту запись в оригинальном датасете (может отсутствовать)
- persons — список персон, которые были упомянуты в документе (может отсутствовать)
- companies — список компаний, которые были упомянуты в документе (может отсутствовать)
- addresses — список адресов, которые были упомянуты в документе (может отсутствовать)
- countries — список стран, которые были упомянуты в документе (может отсутствовать)
Вы также можете использовать параметр entities
в параметра запроса, чтобы ограничить поиск только по компаниям (companies
), персонам (persons
), странам (countries
) или адресам (addresses
).