Дастурчилар учун API

…

Ҳозир корпусда нима бор

Иқтибос қилинадиган корпус ҳали тўлдирилмоқда, шунинг учун қидирув бўш рўйхат қайтариши мумкин. Бу ҳужжат ҳали юкланмагани дегани — бундай қонун йўқ дегани эмас. Ҳар бир жавобдаги meta.coverage_note ни ўқинг ва фойдаланувчига «бундай нарса йўқ» дейишдан олдин қамров саҳифасини текширинг.

Тез бошлаш

1
Лойиҳа яратинг
Лойиҳа калитларингиз ва фойдаланиш ҳажмингизни бирлаштиради. Уни APIга мурожаат қиладиган илова номи билан атанг.
2
API калит яратинг
Махфий калит фақат бир марта — уни яратган ойнада кўрсатилади. Хавфсиз жойда сақланг: бизда фақат хеш қолади, шунинг учун уни қайта кўрсатиб бўлмайди. Калит йўқолса, уни бекор қилиб, янгисини яратинг.
3
Биринчи сўровингизни юборинг
Калитни ҳар бир сўровда bearer token сифатида юборинг.

Асосий манзил

https://lawify.uz/api/v1

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

Authorization: Bearer lwf_live_xxxxxxxx_…

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

Калитни ҳеч қачон браузер кодига, мобил илова пакетига ёки очиқ репозиторийга жойлаштирманг. Қурилмага юборилган ҳар қандай нарсани ўқиб олиш мумкин — APIга ўз серверингиздан мурожаат қилинг.

Эндпойнтлар

Эндпойнт	Рухсат	Нима қайтаради
GET`/api/v1/search`	`search:read`	Чоп этилган ҳуқуқий нормалар бўйича қидирув.
GET`/api/v1/domains`	`corpus:read`	Қайси ҳуқуқ соҳалари бўйича филтрлаш мумкинлиги ва калитингиз қайсиларини олади.
GET`/api/v1/provisions/{id}`	`corpus:read`	Битта норма — матни ва кучга кириш саналари билан.
GET`/api/v1/documents/{id}`	`corpus:read`	Битта норматив ҳужжат ва унинг нормалари.
GET`/api/v1/changes`	`changes:read`	Белгиланган санадан кейин қўшилган, ўзгартирилган ёки бекор қилинган нормалар.
POST`/api/v1/answer`	`answer:write`	Ҳуқуқий саволга манбаларга асосланган жавоб, манбалари билан.
POST`/api/v1/mcp`	`corpus:read`	Model Context Protocol эндпойнти — AI агентни улаш учун.

API маълумотномаси OpenAPI JSON кўриниши

Ҳуқуқ соҳаси бўйича филтрлаш

`domains` параметри билан фақат ўзингизга керак бўлган соҳани сўранг. Нотўғри ном 400 хато беради — жимгина эътиборсиз қолдирилмайди, чунки ишламаётган филтрни сезмасдан қолиш энг қиммат хато.

constitutionalcivilcriminaladministrativelabourfamilyhousingconsumertaxbusinesstrafficdigitalintellectual-propertylandprocedure

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

Жавобдаги `filter.mode` филтр қанчалик қатъий ишлаганини айтади: `exact` — соҳа ташқарисидаги ҳеч нарса умуман олинмаган; `best_effort` — натижалар ҳужжат номи бўйича кейин ажратилган, шунинг учун камроқ натижа келиши мумкин, лекин ҳеч қачон соҳа ташқарисидан эмас.

Калитнинг ўзини ҳам чеклаш мумкин. Бунда соҳа ташқарисидаги сўров 403 қайтаради — яъни муаммо қонунда эмас, калитда экани дарҳол кўринади.

Рухсатлар

Калит фақат сиз берган рухсатларга эга бўлади. Янги калитлар корпус, қидирув ва ўзгаришларни ўқиш ҳуқуқини олади. Интеграцияга камроқ керак бўлса, торроқ тўплам сўранг.

Чекловлар

Бета лойиҳалар учун ойига 10 000 та ва дақиқасига 60 та сўров. Ҳар бир жавобда x-ratelimit-limit ва x-ratelimit-remaining сарлавҳалари бўлади.

Жавоб эндпойнти бета тарифда ёқилмаган. Интеграциянгизга керак бўлса, ceo@oxforder.uz манзилига ёзинг.

Хатоликлар

Ҳар бир хатолик бир хил конвертда қайтади. Мантиқни code бўйича қуринг, message бўйича эмас — message матни ўзгариши мумкин.

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

Статус	Код	Нима қайтаради
401	`unauthorized`	API калит йўқ ёки нотўғри.
403	`forbidden`	Калитда керакли рухсат йўқ ёки тарифингиз бу endpointни қамрамайди.
404	`not_found`	Бундай id билан чоп этилган модда ёки ҳужжат топилмади.
400	`invalid_request`	Параметрлар нотўғри — хабарда майдон номи кўрсатилади.
429	`rate_limited`	Сўровлар жуда кўп. Retry-After сарлавҳасига амал қилинг.
500	`internal_error`	Бу бизнинг хатомиз. Бир марта қайта уриниб кўринг, сўнг request_id ни юборинг.

AI агентда ишлатиш

Тайёр skill тўплами: endpointлар, иқтибос қоидалари ва агент қонун ҳақида жавоб беришдан олдин билиши шарт бўлган қамров огоҳлантириши. Claude Code ва SKILL.md ўқийдиган ҳар қандай агент билан ишлайди, MCP конфигурацияси ҳам бор.

Skill тўпламини юклаб олиш

1. Skills папкангизга очинг: SKILL.md файли .claude/skills/lawify-legal-corpus/ ичида бўлсин.
2. Юқоридаги калит билан LAWIFY_API_KEY ни ўрнатинг.
3. Агентдан Ўзбекистон қонунчилигига оид савол сўранг — у skillни ўзи юклайди.

Ёки MCP орқали уланг

MCP эндпойнти бир хил корпусни ҳар қандай Model Context Protocol мижозига очади. Мижозингизни унга йўналтиринг ва худди шу bearer token билан аутентификация қилинг.

MCP мижоз конфигурацияси

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