Bazaviy API
Nizomning 40-bandiga muvofiq e’lon qilinadi · asos manzil:
https://api.dri.milliykengash.com
O‘qish manzillari ochiq va bepul — kalit talab qilinmaydi.
Yozish manzillari (depozit, yangilash) a’zolik API kaliti bilan
ishlaydi; kalit Operator tomonidan beriladi va
Authorization: Bearer uzk_… sarlavhasida uzatiladi.
Ochiq manzillar (kalitsiz)
| Manzil | Nima qiladi |
|---|---|
GET /health |
Xizmat holati — monitoring uchun |
GET /v1/identifiers/{prefiks}/{suffiks} |
Yozuvning to‘liq ochiq kartochkasi (JSON) |
GET /v1/search?q=&year=&member=&limit=&cursor= |
Registr bo‘ylab qidiruv. Standart 20, eng ko‘pi 100 natija; sahifalash kursor bilan |
GET /v1/members/{id}/identifiers |
Bitta a’zoning barcha yozuvlari |
Yozuv sahifasidan eksport (resolver domenida):
GET id.…/api/{prefiks}/{suffiks} | JSON |
GET id.…/api/{prefiks}/{suffiks}?format=bibtex | BibTeX |
GET id.…/api/{prefiks}/{suffiks}?format=ris | RIS |
A’zo manzillari (API kaliti bilan)
| Manzil | Nima qiladi | Ruxsat |
|---|---|---|
POST /v1/deposits |
Bitta yozuv depoziti — 12 tekshiruvdan o‘tadi, identifikator qaytaradi | deposit |
POST /v1/deposits/batch |
Bir so‘rovda 500 tagacha yozuv. Atomar emas: natija har element bo‘yicha alohida qaytadi | deposit |
PATCH /v1/identifiers/{p}/{s} |
Ish manzilini (target_url) yangilash — havola ko‘chganda | update |
POST /v1/identifiers/{p}/{s}/status |
Holatni o‘zgartirish (masalan chaqirib olish) — sabab majburiy | update |
PUT /v1/objects/{id}/metadata |
Metama’lumotni tuzatish (Nizom, 44-band asoslari bilan) | update |
Texnik chegaralar
Nizom 40-band: barcha foydalanuvchilar uchun teng imkoniyat maqsadida
| Chegara | Qiymat |
|---|---|
| Depozit (a’zoga) | 100 ta / daqiqa |
| Guruhli depozit (a’zoga) | 5 ta / daqiqa |
| IP bo‘yicha umumiy | 600 so‘rov / daqiqa |
| So‘rov tanasi | 20 MB gacha |
| Guruh hajmi | 500 element |
Chegara oshib ketsa 429 va Retry-After
sarlavhasi qaytadi.
Depozit formatlari
Kabinet orqali yuklashda uch format qabul qilinadi va tizim ularni mazmuniga qarab o‘zi taniydi:
| Crossref XML | Crossref’ga tayyorlangan deposit fayl o‘zgarishsiz ishlaydi;
mavjud DOI external_doi sifatida saqlanadi |
| CSV | Excel’dan eksport; ustun nomlari o‘zbekcha yoki inglizcha.
suffiks ustuni bilan o‘z suffiksingizni berish
mumkin |
| JSON | API bilan bir xil shakl — dasturiy integratsiya uchun |
Xatolar
Har xato yopiq ro‘yxatdagi kod bilan qaytadi:
{"error":{"code":"…","field":"…","message":"…","message_en":"…"}}.
Ko‘p uchraydiganlari:
MISSING_FIELD · 400 | Majburiy maydon yetishmaydi |
INVALID_BODY · 400 | Maydon shakli noto‘g‘ri |
URL_UNREACHABLE · 422 | Ish manzili ochilmadi — depozitdan oldin sahifa mavjud bo‘lishi shart |
DUPLICATE_OBJECT · 409 | Bu ish allaqachon ro‘yxatga olingan (javobda mavjud identifikator) |
SUFFIX_TAKEN · 409 | Qo‘lda berilgan suffiks band |
RATE_LIMITED · 429 | Chegara oshdi — Retry-After ni kuting |
Identifikator shakli
20.PPPP/suffiks — bu yerda PPPP a’zoning
to‘rt xonali prefiksi. Suffiks a–z 0–9 - belgilaridan,
4–32 uzunlikda. Avtomatik rejimda suffiks nazorat belgisi bilan
yaratiladi: bitta belgida xato yoki qo‘shni belgilar almashib
ko‘chirilgan identifikator so‘rovsiz aniqlanadi.
9000–9999 prefikslari — sinov diapazoni: bunday yozuvlar real
hisoblanmaydi va qidiruv tizimlariga chiqarilmaydi (Nizom, 11-band).