Islep shıǵarıwshılar ushın API

…

Házir korpusta ne bar

Sıltemege alınatuǵın korpus áli tolтırılıp atır, sonlıqtan izlew bos dizim qaytarıwı múmkin. Bul hújjet áli júklenbegenin bildiredi — bunday nızam joq degen emes. Hár bir juwaptaǵı meta.coverage_note nı oqıń hám paydalanıwshıǵa «bunday nárse joq» dewden aldın qamraw betin tekseriń.

Tez baslaw

1
Joybar jaratıń
Joybar giltlerińizdi hám paydalanıw kólemin birlestiredi. Onı APIǵa múrájat etetuǵın qosımsha atı menen atań.
2
API gilti jaratıń
Qupıya gilt tek bir márte — onı jaratqan ekranda kórsetiledi. Qáwipsiz jerde saqlań: bizde tek xesh qaladı, sonlıqtan onı qayta kórsetiw múmkin emes. Gilt joǵalsa, onı biykar etip, jańasın jaratıń.
3
Birinshi soraw jiberiń
Giltti hár bir sorawda bearer token sıpatında jiberiń.

Tiykarǵı mánzil

https://lawify.uz/api/v1

Autentifikaciya

Authorization: Bearer lwf_live_xxxxxxxx_…

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

Giltti hesh qashan brauzer kodına, mobil qosımsha paketine yamasa ashıq repozitoriyaǵa jaylastırmań. Qurılmaǵa jiberilgen hár qanday nárseni oqıp alıw múmkin — APIǵa óz serverińizden múrájat etiń.

Endpointler

Endpoint	Ruqsat	Ne qaytaradı
GET`/api/v1/search`	`search:read`	Baspadan shıqqan huqıqıy normalar boyınsha izlew.
GET`/api/v1/domains`	`corpus:read`	Qaysı huqıq tarawları boyınsha filtrlew múmkin hám giltińiz qaysılarına kire aladı.
GET`/api/v1/provisions/{id}`	`corpus:read`	Bir norma — teksti hám kúshke kiriw sáneleri menen.
GET`/api/v1/documents/{id}`	`corpus:read`	Bir normativ hújjet hám onıń normaları.
GET`/api/v1/changes`	`changes:read`	Kórsetilgen sáneden keyin qosılǵan, ózgertilgen yamasa biykar etilgen normalar.
POST`/api/v1/answer`	`answer:write`	Huqıqıy sorawǵa derekler tiykarındaǵı juwap, derekleri menen.
POST`/api/v1/mcp`	`corpus:read`	Model Context Protocol endpointi — AI agentti jalǵaw ushın.

API anıqlaması OpenAPI JSON kórinisi

Huqıq tarawı boyınsha filtrlew

`domains` parametri menen tek ózińizge kerekli tarawdı soraw. Belgisiz atama 400 qátelik qaytaradı — únsiz itibarǵa alınbaydı, sebebi islemeytuǵın filtrdi sezbey qalıw eń qımbat qátelik.

constitutionalcivilcriminaladministrativelabourfamilyhousingconsumertaxbusinesstrafficdigitalintellectual-propertylandprocedure

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

Juwaptaǵı `filter.mode` filtrdiń kúshin aytadı: `exact` — taraw sırtındaǵı hesh nárse alınbaǵan; `best_effort` — nátiyjeler hújjet atı boyınsha izlewden keyin ajıratılǵan, sonlıqtan azıraq nátiyje keliwi múmkin, biraq hesh qashan taraw sırtınan emes.

Gilttiń ózin de sheklew múmkin. Onda taraw sırtındaǵı soraw 403 qaytaradı — másele nızamda emes, giltte ekeni birden kórinedi.

Ruqsatlar

Gilt tek siz bergen ruqsatlarǵa iye boladı. Jańa giltler korpus, izlew hám ózgerislerdi oqıw huqıqın aladı. Integraciyaǵa azıraq kerek bolsa, tarıraq toplam sorań.

Sheklewler

Beta joybarlar ushın ayına 10,000 hám minutına 60 soraw. Hár bir juwapta x-ratelimit-limit hám x-ratelimit-remaining basqıshları boladı.

Juwap endpointi beta tarifte qosılmaǵan. Integraciyańızǵa kerek bolsa, ceo@oxforder.uz mánziline jazıń.

Qátelikler

Hár bir qátelik bir konvertte qaytadı. code boyınsha tarmaqlanıń, message boyınsha emes — message teksti ózgeriwi múmkin.

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

Status	Kod	Ne qaytaradı
401	`unauthorized`	API gilti joq yamasa qáte.
403	`forbidden`	Giltte kerekli ruqsat joq yamasa tariyfińiz bul endpointti qamtımaydı.
404	`not_found`	Bunday id menen baspa etilgen statya yamasa hújjet tabılmadı.
400	`invalid_request`	Parametrler qáte — xabarda maydan atı kórsetiledi.
429	`rate_limited`	Sorawlar júdá kóp. Retry-After sarlawhasın orınlań.
500	`internal_error`	Bul bizdiń qátemiz. Bir ret qayta urınıp kóriń, soń request_id jiberiń.

AI agentte paydalanıw

Tayın skill toplamı: endpointler, siltew qaǵıydaları hám agent nızam haqqında juwap beriwden aldın biliwi shárt bolǵan qamtıw eskertiwi. Claude Code hám SKILL.md oqıytuǵın hár qanday agent penen isleydi, MCP konfiguraciyası da bar.

Skill toplamın júklep alıw

1. Skills papkańızǵa ashıń: SKILL.md faylı .claude/skills/lawify-legal-corpus/ ishinde bolsın.
2. Joqarıdaǵı gilt penen LAWIFY_API_KEY ornatıń.
3. Agentten Ózbekstan nızamshılıǵına baylanıslı soraw sorań — ol skilldi ózi júkleydi.

Yamasa MCP arqalı jalǵanıń

MCP endpointi sol korpustı hár qanday Model Context Protocol klientine ashadı. Klientińizdi soǵan baǵıttań hám usı bearer token menen autentifikaciya etiń.

MCP klient konfiguraciyası

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