Dasturchilar uchun API

…

Hozir korpusda nima bor

Iqtibos qilinadigan korpus hali to'ldirilmoqda, shuning uchun qidiruv bo'sh ro'yxat qaytarishi mumkin. Bu hujjat hali yuklanmagani degani — bunday qonun yo'q degani emas. Har bir javobdagi meta.coverage_note ni o'qing va foydalanuvchiga «bunday narsa yo'q» deyishdan oldin qamrov sahifasini tekshiring.

Tez boshlash

1
Loyiha yarating
Loyiha kalitlaringiz va foydalanish hajmingizni birlashtiradi. Uni API'ga murojaat qiladigan ilova nomi bilan ataning.
2
API kalit yarating
Maxfiy kalit faqat bir marta — uni yaratgan oynada ko'rsatiladi. Xavfsiz joyda saqlang: bizda faqat xesh qoladi, shuning uchun uni qayta ko'rsatib bo'lmaydi. Kalit yo'qolsa, uni bekor qilib, yangisini yarating.
3
Birinchi so’rovingizni yuboring
Kalitni har bir so'rovda bearer token sifatida yuboring.

Asosiy manzil

https://lawify.uz/api/v1

Autentifikatsiya

Authorization: Bearer lwf_live_xxxxxxxx_…

curl -s "https://lawify.uz/api/v1/search?q=mehnat+shartnomasi&limit=5" \
  -H "Authorization: Bearer $LAWIFY_API_KEY"

Kalitni hech qachon brauzer kodiga, mobil ilova paketiga yoki ochiq repozitoriyga joylashtirmang. Qurilmaga yuborilgan har qanday narsani o'qib olish mumkin — API'ga o'z serveringizdan murojaat qiling.

Endpointlar

Endpoint	Ruxsat	Nima qaytaradi
GET`/api/v1/search`	`search:read`	Chop etilgan huquqiy normalar bo'yicha qidiruv.
GET`/api/v1/domains`	`corpus:read`	Qaysi huquq sohalari boʻyicha filtrlash mumkinligi va kalitingiz qaysilarini oladi.
GET`/api/v1/provisions/{id}`	`corpus:read`	Bitta norma — matni va kuchga kirish sanalari bilan.
GET`/api/v1/documents/{id}`	`corpus:read`	Bitta normativ hujjat va uning normalari.
GET`/api/v1/changes`	`changes:read`	Belgilangan sanadan keyin qo'shilgan, o'zgartirilgan yoki bekor qilingan normalar.
POST`/api/v1/answer`	`answer:write`	Huquqiy savolga manbalarga asoslangan javob, manbalari bilan.
POST`/api/v1/mcp`	`corpus:read`	Model Context Protocol endpointi — AI agentni ulash uchun.

API ma'lumotnomasi OpenAPI JSON ko'rinishi

Huquq sohasi boʻyicha filtrlash

`domains` parametri bilan faqat oʻzingizga kerak boʻlgan sohani soʻrang. Notoʻgʻri nom 400 xato beradi — jimgina eʼtiborsiz qoldirilmaydi, chunki ishlamayotgan filtrni sezmasdan qolish eng qimmat xato.

constitutionalcivilcriminaladministrativelabourfamilyhousingconsumertaxbusinesstrafficdigitalintellectual-propertylandprocedure

curl "https://lawify.uz/api/v1/search?q=ishdan+bo'shatish&domains=labour" \
  -H "Authorization: Bearer $LAWIFY_API_KEY"

Javobdagi `filter.mode` filtr qanchalik qatʼiy ishlaganini aytadi: `exact` — soha tashqarisidagi hech narsa umuman olinmagan; `best_effort` — natijalar hujjat nomi boʻyicha keyin ajratilgan, shuning uchun kamroq natija kelishi mumkin, lekin hech qachon soha tashqarisidan emas.

Kalitning oʻzini ham cheklash mumkin. Bunda soha tashqarisidagi soʻrov 403 qaytaradi — yaʼni muammo qonunda emas, kalitda ekani darhol koʻrinadi.

Ruxsatlar

Kalit faqat siz bergan ruxsatlarga ega bo'ladi. Yangi kalitlar korpus, qidiruv va o'zgarishlarni o'qish huquqini oladi. Integratsiyaga kamroq kerak bo'lsa, torroq to'plam so'rang.

Cheklovlar

Beta loyihalar uchun oyiga 10 000 ta va daqiqasiga 60 ta so'rov. Har bir javobda x-ratelimit-limit va x-ratelimit-remaining sarlavhalari bo'ladi.

Javob endpointi beta tarifda yoqilmagan. Integratsiyangizga kerak bo'lsa, ceo@oxforder.uz manziliga yozing.

Xatoliklar

Har bir xatolik bir xil konvertda qaytadi. Mantiqni code boʻyicha quring, message boʻyicha emas — message matni oʻzgarishi mumkin.

{
  "error": {
    "code": "not_found",
    "message": "…",
    "request_id": "…"
  }
}

Status	Kod	Nima qaytaradi
401	`unauthorized`	API kalit yo‘q yoki noto‘g‘ri.
403	`forbidden`	Kalitda kerakli ruxsat yo‘q yoki tarifingiz bu endpointni qamramaydi.
404	`not_found`	Bunday id bilan chop etilgan modda yoki hujjat topilmadi.
400	`invalid_request`	Parametrlar noto‘g‘ri — xabarda maydon nomi ko‘rsatiladi.
429	`rate_limited`	So‘rovlar juda ko‘p. Retry-After sarlavhasiga amal qiling.
500	`internal_error`	Bu bizning xatomiz. Bir marta qayta urinib ko‘ring, so‘ng request_id ni yuboring.

AI agentda ishlatish

Tayyor skill to‘plami: endpointlar, iqtibos qoidalari va agent qonun haqida javob berishdan oldin bilishi shart bo‘lgan qamrov ogohlantirishi. Claude Code va SKILL.md o‘qiydigan har qanday agent bilan ishlaydi, MCP konfiguratsiyasi ham bor.

Skill to‘plamini yuklab olish

1. Skills papkangizga oching: SKILL.md fayli .claude/skills/lawify-legal-corpus/ ichida bo‘lsin.
2. Yuqoridagi kalit bilan LAWIFY_API_KEY ni o‘rnating.
3. Agentdan O‘zbekiston qonunchiligiga oid savol so‘rang — u skillni o‘zi yuklaydi.

Yoki MCP orqali ulaning

MCP endpointi bir xil korpusni har qanday Model Context Protocol mijoziga ochadi. Mijozingizni unga yo'naltiring va xuddi shu bearer token bilan autentifikatsiya qiling.

MCP mijoz konfiguratsiyasi

{
  "mcpServers": {
    "lawify-legal-corpus": {
      "type": "http",
      "url": "https://lawify.uz/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${LAWIFY_API_KEY}"
      }
    }
  }
}