API предоставляет собой интерфейс для информационного взаимодействия с разделом – «Официальное опубликование» (publication.pravo.gov.ru), «Официального интернет-портала правовой информации» (www.pravo.gov.ru). С предлагаемым интерфейсом могут взаимодействовать как веб-сервисы, так и приложения.
Взаимодействие с API производится только в режиме чтения. Методов для записи данных в систему не предоставляется.
Запрос списка блоков публикации и под-блоков
- позволяет получить необходимый список Блоков публикации (БП), включая вложенные подблоки.
URL запроса на получение списка блоков публикации: …/api/PublicBlocks/
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
parent |
Код блока, у которого надо получить все дочерние блоки |
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные.
В JSON файле ответа содержится структурированный список записей, соответствующих Блокам публикации (БП) и относящимся к ним подблокам (пока используется один уровень вложенности).
Каждая запись о БП (и подблоке) содержит следующий набор полей:
ПОЛЕ JSON |
ОПИСАНИЕ |
||||||||
"id" |
GUID Блока публикации (БП) |
||||||||
"shortName" |
Краткое имя |
||||||||
"name" |
Полное наименование БП |
||||||||
"menuName" |
Наименование БП в меню |
||||||||
"code" |
Код Блока публикации |
||||||||
"description" |
Описание |
||||||||
"weight" |
Вес для сортировки |
||||||||
"isBlocked" |
Признак временной блокировки Блока публикации |
||||||||
"parentId" |
GUID родительского Блока публикации (для подблока) |
||||||||
"hasChildren" |
Признак наличия дочерних подблоков |
||||||||
"isAgenciesOfStateAuthorities" |
Признак: БП соответствует органу исполнительной власти РФ |
||||||||
"imageId" |
GUID картинки с символом БП |
||||||||
"categories" |
Категории БП, уточняющий вид ФОИВ - заполняется в частности для БП «ОГВ Субъектов РФ» (subjects).
|
||||||||
"section" |
Подраздел БП, уточняющий вид ФОИВ - заполняется только для БП «ФОИВ и ФГО РФ» (federal_authorities).
|
||||||||
"parent" |
Устаревший вариант parentId. |
||||||||
"treeViewParentId" |
Устаревший параметр для БП ФОИВ. |
||||||||
"items" |
Список Подблоков публикации (дочерних БП по отношению к родительскому БП). |
||||||||
Набор полей записей по подблоку (в объекте "items") аналогичен таковому в БП |
|||||||||
Пример запроса:
…/api/PublicBlocks?parent=assembly – запрос подблоков Блока "Федеральное Собрание Российской Федерации"
Пример содержания ответа:
[
{
"shortName": "Совет Федерации ФС РФ",
"menuName": "Совет Федерации ФС РФ",
"code": "council_1",
"description": "Постановления Совета Федерации, принятые по вопросам, \r\nотнесенным к ведению палаты частью 1 статьи 102 \r\nКонституции Российской Федерации",
"weight": 999,
"isBlocked": false,
"parent": null,
"section": null,
"parentId": "a30c9c82-4a21-48ab-a41d-d1891a10962c",
"hasChildren": false,
"isAgenciesOfStateAuthorities": false,
"items": [],
"imageId": "bef4c47c-65c4-41f8-8d3b-b3f5f44eaf16",
"categories": null,
"treeViewParentId": null,
"name": "Совет Федерации Федерального Собрания Российской Федерации",
"id": "950cdcb1-f55d-4e22-9f05-87074fe08efd"
},
{
"shortName": "Государственная Дума ФС РФ",
"menuName": "Государственная Дума ФС РФ",
"code": "council_2",
"description": "Постановления Государственной Думы, принятые по вопросам, \r\nотнесенным к ведению палаты частью 1 статьи 103 \r\nКонституции Российской Федерации",
"weight": 998,
"isBlocked": false,
"parent": null,
"section": null,
"parentId": "a30c9c82-4a21-48ab-a41d-d1891a10962c",
"hasChildren": false,
"isAgenciesOfStateAuthorities": false,
"items": [],
"imageId": "13428305-e992-4611-a89e-a478b6eeb917",
"categories": null,
"treeViewParentId": null,
"name": "Государственная Дума Федерального Собрания Российской Федерации",
"id": "0dbe1bc1-0e40-446a-a3ba-1ccabe18ca5e"
}
]
Запрос списка категорий принявших органов
- позволяет получить необходимый список Категорий принявших органов.
URL запроса на получение списка блоков публикации: …/api/Categories
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
ОБЯЗАТЕЛЬНЫЙ |
block |
Код блока публикации, для которого необходимо отобразить Категории |
Да |
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные.
В JSON файле ответа содержится структурированный список записей, соответствующих Категориям. Каждая запись о Категории содержит следующий набор полей:
ПОЛЕ JSON |
ОПИСАНИЕ |
"id" |
GUID Категории |
"name" |
Полное наименование |
"code" |
Код Категории |
Пример запроса:
…/api/Categories?block="government" – запрос Категорий принявших органов по Блоку публикации "Правительство Российской Федерации".
Пример содержания ответа:
[
{
"code": "iogv",
"name": "Органы исполнительной власти",
"id": "aeeef2f5-6bb7-4b4a-a102-88950eab4858"
},
{
"code": "sudr",
"name": "Судебные решения",
"id": "11b96c77-9ef2-4ed2-b318-bb483917861d"
},
{
"code": "mogv",
"name": "Органы местного самоуправления",
"id": "3c4d57c2-47dd-465e-81cc-c5c665771b1e"
},
{
"code": "vogv",
"name": "Высшие органы государственной власти",
"id": "9d29f60a-1569-4f63-a914-e71196c61841"
}
]
Запрос списка принявших органов
- позволяет получить необходимый список Принявших органов (ПО).
URL запроса на получение списка блоков публикации: …/api/SignatoryAuthorities
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
block |
Код блока публикации |
сategory |
Код Категории ПО |
Все параметры являются необязательными.
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные.
В JSON файле ответа содержится структурированный список записей, соответствующих Принявшим органам (ПО). Каждая запись о ПО содержит следующий набор полей:
ПОЛЕ JSON |
ОПИСАНИЕ |
"id" |
GUID Принявшего органа |
"name" |
Полное наименование |
"weight " |
Вес для сортировки |
Пример запроса:
…/api/SignatoryAuthorities?block=government – запрос принявших органов по Блоку публикации "Правительство Российской Федерации"
Пример содержания ответа:
[
{
"weight": 93000,
"name": "Правительство Российской Федерации",
"id": "8005d8c9-4b6d-48d3-861a-2a37e69fccb3"
}
]
Запрос списка видов документов
- позволяет получить необходимый список Видов документов (ВД).
URL запроса на получение списка блоков публикации: …/api/DocumentTypes
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
block |
Код блока публикации |
сategory |
Код Категории ПО |
SignatoryAuthorityId |
GUID Принявшего органа |
Все параметры являются необязательными.
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные.
В JSON файле ответа содержится структурированный список записей, соответствующих Видам документов. Каждая запись о ПО содержит следующий набор полей:
ПОЛЕ JSON |
ОПИСАНИЕ |
"id" |
GUID вида документа |
"name" |
Полное наименование |
"weight " |
Вес для сортировки |
Пример запроса:
…/api/DocumentTypes?SignatoryAuthorityId=8005d8c9-4b6d-48d3-861a-2a37e69fccb3 – запрос Видов документов по Принявшему органу "Правительство Российской Федерации "
Пример содержания ответа:
[
{
"weight": 95,
"name": "Постановление",
"id": "fd5a8766-f6fd-4ac2-8fd9-66f414d314ac"
},
{
"weight": 94,
"name": "Распоряжение",
"id": "7ff5b3b5-3757-44f1-bb76-3766cabe3593"
}
]
Запрос списка документов (поиск документов)
Основным запросом к API является поиск по документам (нормативно-правовым актам - НПА), который возвращает список найденных документов. Широкий набор параметров запроса позволяет фильтровать коллекцию запрашиваемых документов по различным критериям. Некоторые из этих параметров являются идентификаторами объектов из справочников, приведенных выше (Блок публикации, Категория принимающего органа, Принимающий орган, Вид документа).
URL запроса на получение списка НПА: …/api/Documents
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
Block |
Код блока публикации |
Category |
Код Категории принимающего органа |
SignatoryAuthorityId |
GUID Принявшего органа |
DocumentTypeId |
GUID вида документа (можно использовать несколько значений) |
EoNumber |
Номер электронного опубликования |
PeriodType |
Фиксированный временной период выборки данных по дате опубликования: «daily» - выборка НПА, опубликованных Сегодня «weekly» - выборка за текущую Неделю (с Пн по Вс) «monthly» - выборка за текущий Месяц «day» - выборка за определенный день, который указывается в параметре «Date» |
Date |
Дата опубликования документов, если параметр PeriodType указан как «Day» |
DocumentDateFrom |
Дата подписания документа – начало периода поиска |
DocumentDateTo |
Дата подписания документа – конец периода поиска |
Name |
Название документа |
ComplexName |
Составное название документа, включающее вид, дату и номер НПА, а также название принимающего органа |
NumberSearchType |
Режим поиска по номеру НПА, возможны следующие значения: 0 – точно 1 – начинается с 2 – заканчивается на 3 – содержит |
Number |
Номер документа (НПА) – режим поиска, в соответствии с параметром «NumberSearchType» |
JdRegNumber |
Номер регистрации в Минюсте |
JdRegDateFrom |
Дата регистрации в Минюсте – начало периода поиска |
JdRegDateTo |
Дата регистрации в Минюсте– конец периода поиска |
PublishDateFrom |
Дата публикации НПА – начало периода поиска |
PublishDateTo |
Дата публикации НПА – конец периода поиска |
DocumentText |
Текст документа |
PageSize |
Количество возвращаемых записей на страницу, возможны следующие значения: 10, 30, 100, 200 |
Index |
Номер страницы результатов, которую необходимо отобразить. |
SortedBy |
Параметр, по которому должна выполняться сортировка: 0 – Дата подписания 1 – Вид документа 2 – Принявший орган 3 – Номер документа 4 – Дата опубликования 5 – Номер опубликования |
SortDestination |
Направление сортировки:
|
Все параметры являются необязательными.
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные – список документов, соответствующий критериям (параметрам) запроса.
В JSON файле ответа содержится структурированный список записей, соответствующих выбранным документам. Данные о документах будут содержать следующий набор полей:
ПОЛЕ JSON ФАЙЛА |
ОПИСАНИЕ |
|||||||||||||||||||||||||||||||||||||
"items" |
Список документов - представлен как набор нескольких вложенных объектов (записей): |
|||||||||||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||||||||||
"itemsTotalCount" |
Всего элементов (документов) в итоговой выборке |
|||||||||||||||||||||||||||||||||||||
"itemsPerPage" |
Количество элементов выводимых на одной странице списка |
|||||||||||||||||||||||||||||||||||||
"pagesTotalCount" |
Общее кол-во страниц при постраничном отображении списка документов |
|||||||||||||||||||||||||||||||||||||
"currentPage" |
Номер текущей отображаемой страницы списка документов |
|||||||||||||||||||||||||||||||||||||
Пример запроса:
…/api/Documents?DocumentTypes=2dddb344-d3e2-4785-a899-7aa12bd47b6f
&NumberSearchType=0&Number=3 – запрос документов, вида «Приказ» и номер которого точно равен «3».
Пример содержания ответа:
{
"items": [
{
"eoNumber": "7601202402290003",
"hasSvg": false,
"zipFileLength": null,
"publishDateShort": "2024-02-29T00:00:00",
"complexName": "Приказ министерства дорожного хозяйства Ярославской области от 28.02.2024 № 3\n \"О внесении изменений в приказ департамента дорожного хозяйства Ярославской области от 18.12.2019 № 13\"",
"pagesCount": 3,
"pdfFileLength": 87274,
"jdRegNumber": "40-14604",
"jdRegDate": "2024-02-29T00:00:00",
"name": "О внесении изменений в приказ департамента дорожного хозяйства Ярославской области от 18.12.2019 № 13",
"number": "3",
"documentDate": "2024-02-28T00:00:00",
"signatoryAuthorityId": "68a78349-f153-4222-9b5a-9bdafa7c53c5",
"documentTypeId": "2dddb344-d3e2-4785-a899-7aa12bd47b6f",
"title": "Приказ министерства дорожного хозяйства Ярославской области от 28.02.2024 № 3\u003Cbr /\u003E \"О внесении изменений в приказ департамента дорожного хозяйства Ярославской области от 18.12.2019 № 13\"\u003Cbr/\u003E(Зарегистрирован 29.02.2024 № 40-14604)",
"viewDate": "29.02.2024",
"id": "a25b4689-7f38-43ec-b542-b4db1a924030"
}
],
"itemsTotalCount": 1,
"itemsPerPage": 30,
"currentPage": 1,
"pagesTotalCount": 1
}
Запрос параметров отдельного документа
- позволяет получить расширенный набор параметров документа по номеру его электронного опубликования.
URL запроса на получение списка блоков публикации: …/api/Document
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
ОБЯЗАТЕЛЬНЫЙ |
eoNumber |
Номер электронного опубликования |
Да |
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные.
В JSON файле ответа будет содержаться запись, соответствующая запрошенному документу, которая содержит следующий набор полей:
ПОЛЕ JSON |
ОПИСАНИЕ |
|||||||||||
"id" |
GUID документа |
|||||||||||
"eoNumber" |
Номер электронного опубликования |
|||||||||||
"publishDateShort" |
Дата публикации в формате ISO 8601 |
|||||||||||
"viewDate" |
Дата публикации в формате DD.MM.YYYY |
|||||||||||
"title" |
Заголовок документа |
|||||||||||
"complexName" |
Полное составное название документа, включающее Вид, Дату и Номер документа, Принявший орган |
|||||||||||
"jdRegNumber" |
Номер регистрации в Минюсте |
|||||||||||
"jdRegDate" |
Дата регистрации в Минюсте |
|||||||||||
"name" |
Название документа |
|||||||||||
"number" |
Номер документа |
|||||||||||
"documentDate" |
Дата подписания документа |
|||||||||||
"signatoryAuthorityId" |
GUID Принявшего органа |
|||||||||||
"documentTypeId" |
GUID Вида документа |
|||||||||||
"pagesCount" |
Количество страниц в PDF файле документа |
|||||||||||
"pdfFileLength" |
Размер в байтах PDF файла документа |
|||||||||||
"zipFileLength" |
Размер в байтах ZIP файла с приложениями, если таковой имеется |
|||||||||||
"hasSvg" |
Признак: у документа есть прикрепленные SVG файлы |
|||||||||||
|
|
|||||||||||
|
|
|||||||||||
Пример запроса:
…/api/Document?eoNumber=2600202104190001– запрос параметров документа, опубликованного с эл.номером «2600202104190001»
Пример содержания ответа:
{
"documentType": {
"weight": 95,
"name": "Постановление",
"id": "fd5a8766-f6fd-4ac2-8fd9-66f414d314ac"
},
"signatoryAuthorities": [
{
"isMain": true,
"weight": 53970,
"name": "Правительство Ставропольского края",
"id": "3d93f00f-1af0-4669-8f98-0bff04215eb3"
}
],
"eoNumber": "2600202104190001",
"hasSvg": false,
"zipFileLength": null,
"publishDateShort": "2021-04-19T00:00:00",
"complexName": "Постановление Правительства Ставропольского края от 14.04.2021 № 170-п\n \"О внесении изменения в состав совета молодых ученых и специалистов Ставропольского края, утвержденный постановлением Правительства Ставропольского края от 23 июня 2009 г. № 165-п\"",
"pagesCount": 5,
"pdfFileLength": 123731,
"jdRegNumber": "",
"jdRegDate": null,
"name": "О внесении изменения в состав совета молодых ученых и специалистов Ставропольского края, утвержденный постановлением Правительства Ставропольского края от 23 июня 2009 г. № 165-п",
"number": "170-п",
"documentDate": "2021-04-14T00:00:00",
"signatoryAuthorityId": "3d93f00f-1af0-4669-8f98-0bff04215eb3",
"documentTypeId": "fd5a8766-f6fd-4ac2-8fd9-66f414d314ac",
"title": "Постановление Правительства Ставропольского края от 14.04.2021 № 170-п\u003Cbr /\u003E \"О внесении изменения в состав совета молодых ученых и специалистов Ставропольского края, утвержденный постановлением Правительства Ставропольского края от 23 июня 2009 г. № 165-п\"",
"viewDate": "19.04.2021",
"id": "94af1cd0-fd0c-473a-b972-fe39b949c0e5"
}
Запрос статистики опубликования документов
- позволяет получить данные о количестве опубликованных на Портале документов в разрезе Блоков публикации за последний выбранный отрезок времени.
URL запроса на получение списка блоков публикации: …/api/SignatoryAuthorities
Параметры запроса:
ПАРАМЕТР |
ОПИСАНИЕ |
ОБЯЗАТЕЛЬНЫЙ |
period |
Временной период за который рассчитываются данные. |
Да |
Формат ответа:
В ответ на отправленный запрос API вернет текст (файл) в формате JSON, который содержит запрашиваемые данные.
В JSON файле ответа содержится структурированный список записей, соответствующих Принявшим органам (ПО). Каждая запись о ПО содержит следующий набор полей:
ПОЛЕ JSON |
ОПИСАНИЕ |
"block" |
Код блока публикации |
"documentsCount" |
Количество опубликованных на Портале документов |
Пример запроса:
…/api/BlockStatistics/daily – запрос статистики опубликованных документов за последний день.
Пример содержания ответа:
[
{
"block": "president",
"documentsCount": 4
},
{
"block": "assembly",
"documentsCount": 6
},
{
"block": "government",
"documentsCount": 1
},
{
"block": "federal_authorities",
"documentsCount": 114
},
{
"block": "court",
"documentsCount": 2
},
{
"block": "subjects",
"documentsCount": 167
},
{
"block": "international",
"documentsCount": 1
},
{
"block": "un_securitycouncil",
"documentsCount": 1
}
]