Открытый 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).