Техническая документация

API и интеграция

Открытый интерфейс чтения доступен всем, а интерфейс отправки записей — организациям, подписавшим соглашение. Все запросы выполняются по HTTPS, ответы возвращаются в формате JSON.

Базовый адрес: api.nationaldri.uz/v1Тестовая среда: пока недоступна

Основные запросы

GET/works/{dri}Открыто

Возвращает полные метаданные одной записи.

{
  "dri": "20.1000/mtv/2026/i8/41114581",
  "status": "active",
  "type": "article",
  "title": "XALQ EPIK MEROSI (DOSTON VA MAQOLLAR)NING…",
  "authors": [{ "full_name": "Turdiyev Azizbek Anvarjonovich", "sequence": 1 }],
  "journal": { "code": "mtv", "name": "Maktab ta’limi: muammolar, izlanishlar, yechimlar" },
  "issue": { "year": 2026, "volume": null, "number": "8" },
  "language": "uz",
  "target_url": "https://journal.avloniy.uz/uz/article/xalq-epik-merosi-doston-va-maqollarning-oquvchilar-xulq-atvor-madaniyatini-shakllantirishdagi-didaktik-imkoniyatlari",
  "institution": { "name": "Abdulla avloniy" },
  "created_at": "2026-09-23T12:11:35.865390Z",
  "updated_at": "2026-09-23T12:11:35.827008Z",
  …
}

GET/search?q=&type=&year_from=&year_to=&institution=&page=Открыто

Поиск по реестру. Постраничный вывод управляется параметрами page и page_size (по умолчанию 20, не более 100).

POST/worksТребуется токен

Отправляет новую запись. В ответе возвращается окончательный DRI: он выдаётся сразу после автоматической технической проверки. Заголовок Idempotency-Key обязателен — повторный запрос не создаёт второй DRI.

PATCH/works/{dri}/target-urlТребуется токен

Сохраняет или обновляет ссылку на внешнюю страницу статьи. Изменить идентификатор нельзя.

Аутентификация

Для отправки записей организации выдаётся токен. Токен передаётся в заголовке каждого запроса; раскрывать его запрещено.

Authorization: Bearer <token>
Content-Type: application/json
Accept-Language: ru

Срока действия у токена нет: он работает, пока его не отзовут в кабинете.

Ограничение запросов

Для открытого интерфейса — 120 запросов в минуту; с токеном — 600 запросов в минуту.

Коды ошибок

400 — неверная структура запроса

401 — токена нет или он недействителен

409 — обнаружена повторная запись

422 — метаданные не соответствуют требованиям

429 — превышен лимит запросов

Тестовая среда

Записи из песочницы не попадают в публичный реестр и могут быть удалены в любой момент.

Полное описание генерируется из кода автоматически: интерактивная документация (Swagger UI) и схема OpenAPI (JSON).

Грамматика DRI

Форма идентификатора показывает, какой объект он обозначает; формы не взаимозаменяемы. В примерах использован тестовый префикс 20.9999 — он выдаётся только в тестовой среде.

Объект	Пример
Статья — том и выпуск известны	`20.9999/talim/2026/v12_i3/48213907`
Статья — известен только выпуск	`20.9999/talim/2026/i3/73582146`
Статья — выпуск неизвестен	`20.9999/91630482`
Сам выпуск журнала	`20.9999/talim/2026/v12_i3`
Сборник конференции	`20.9999/konf/2026`
Тезис — порядковый номер в сборнике	`20.9999/konf/2026/17`
Диссертация	`20.9999/tdu/d2026/4`
Книга	`20.9999/nashr/b2026/12`

Идентификатор не меняется. Выданный DRI никогда не переносится на другую работу и не удаляется. Если статья загружена не в тот выпуск, выдаётся новый идентификатор, а прежний сохраняется и перенаправляет на новый. Отозванная работа тоже открывается — страница паспорта сообщает об отзыве.

Требования к метаданным

Поля, которые система проверяет при загрузке записи. Список берётся из самого реестра, поэтому всегда совпадает с правилами проверки загрузки.

Статья`article`

Поле	Обязательно	Ограничение	Примечание
`title`	Да	`<= 1000`	Заголовок статьи на языке оригинала.
`authors`	Да	`>= 1`	Как напечатано в документе. Имя и фамилия по отдельности - лучше, но не обязательно: иначе сохраняется полное имя.
`language`	Да	`—`	Язык статьи, а не язык интерфейса.
`published_year`	Да	`1900..2027`	Хотя бы год. Полная дата сохраняется, если она известна.
`abstract`	Да	`<= 10000`	ТЗ 5.7 требует его для статьи.
`keywords`	Да	`3..15`	От трёх до пятнадцати.
`pdf`	Да	`—`	Файл должен быть PDF, и это проверяется по байтам, а не по расширению. Файл остаётся закрытым.
`journal / issue`	Нет	`—`	Если выпуск известен, код журнала и номер входят в DRI. Если нет - выдаётся короткая форма, её можно исправить позже.
`pages, UDC, licence, external links`	Нет	`—`	Сохраняется, если есть; отсутствующее не выдумывается (D03).

Тезис, диссертация и книга`thesis, dissertation, book`

Поле	Обязательно	Ограничение	Примечание
`title`	Да	`<= 1000`	Заголовок документа.
`language`	Да	`—`	Язык документа.
`year`	Да	`1900..2027`	Входит в DRI, поэтому потом не меняется.
`ordinal`	Нет	`>= 1`	Если не указан, предлагается следующий свободный номер. Занятый номер не сдвигается, а отклоняется: иначе он противоречил бы напечатанному сборнику.