Technical documentation

API and integration

The open read interface is available to everyone; the interface for submitting records is provided to institutions that have signed an agreement. All requests go over HTTPS, and responses are returned as JSON.

Base URL: api.nationaldri.uz/v1Test environment: not available yet

Main requests

GET/works/{dri}Open

Returns the full metadata of a single record.

{
  "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=Open

Searches the registry. Paging is controlled by the page and page_size parameters (20 by default, 100 at most).

POST/worksToken required

Submits a new record. The response carries the final DRI: it is issued as soon as the automatic technical checks pass. The Idempotency-Key header is required — a repeated request does not create a second DRI.

PATCH/works/{dri}/target-urlToken required

Saves or updates the link to the article’s external page. The identifier cannot be changed.

Authentication

An institution is given a token for submitting records. The token is sent in a header with every request, and disclosing it is prohibited.

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

A token has no expiry date: it works until it is revoked in the cabinet.

Request limits

120 requests per minute for the open interface; 600 requests per minute with a token.

Error codes

400 — malformed request

401 — token missing or invalid

409 — duplicate record detected

422 — metadata does not meet the requirements

429 — request limit exceeded

Test environment

Records in the sandbox never reach the public registry and may be cleared at any time.

The full description is generated from the code automatically: interactive documentation (Swagger UI) and the OpenAPI schema (JSON).

The DRI grammar

An identifier’s shape says what kind of object it identifies, and the forms are not interchangeable. The examples use the test prefix 20.9999, which is issued only in the test environment.

Object	Example
Article — volume and issue known	`20.9999/talim/2026/v12_i3/48213907`
Article — issue known, no volume	`20.9999/talim/2026/i3/73582146`
Article — issue not known	`20.9999/91630482`
A journal issue itself	`20.9999/talim/2026/v12_i3`
A conference proceedings volume	`20.9999/konf/2026`
Thesis — its position in the volume	`20.9999/konf/2026/17`
Dissertation	`20.9999/tdu/d2026/4`
Book	`20.9999/nashr/b2026/12`

An identifier never changes. An issued DRI is never reassigned to another work and never deleted. If an article was uploaded to the wrong issue a new identifier is issued, and the earlier one is kept and redirects to it. A withdrawn work still resolves — its passport page says it was withdrawn.

Metadata requirements

The fields the system checks when a record is uploaded. The list is read from the registry itself, so it always matches the rules an upload is checked against.

Article`article`

Field	Required	Limit	Note
`title`	Yes	`<= 1000`	The article's title in its own language.
`authors`	Yes	`>= 1`	As printed in the document. Given and family names separately are better but not required; otherwise the full name is kept as it is.
`language`	Yes	`—`	The article's language, not the interface's.
`published_year`	Yes	`1900..2027`	At least the year. A full date is kept as well when it is known.
`abstract`	Yes	`<= 10000`	TZ 5.7 marks it mandatory for an article.
`keywords`	Yes	`3..15`	Between three and fifteen.
`pdf`	Yes	`—`	It must be a PDF, and that is decided by the bytes rather than by the extension. The file stays private.
`journal / issue`	No	`—`	With a known issue the journal code and the issue appear inside the DRI. Without one the short form is issued and can be corrected later.
`pages, UDC, licence, external links`	No	`—`	Kept when present and never invented when absent (D03).

Thesis, dissertation and book`thesis, dissertation, book`

Field	Required	Limit	Note
`title`	Yes	`<= 1000`	The document's title.
`language`	Yes	`—`	The document's language.
`year`	Yes	`1900..2027`	It goes inside the DRI, so it does not change afterwards.
`ordinal`	No	`>= 1`	Omitted, the next free number is proposed. A taken number is refused rather than moved - moving it would publish an identifier that contradicts the printed volume.