🇺🇿 🇷🇺
Ctrl + K

API Hujjatlari

XKT-10.VENA.UZ API hujjatlari va foydalanish ko'rsatmalari

MKB-10 tibbiy klassifikatsiya kodlari uchun RESTful API

Versiya: 1.0
Base URL: https://xkt-10.vena.uz/api/mkb10
Autentifikatsiya: API kalit talab qilinmaydi. Ochiq API.
Cheklovlar: Daqiqasiga 100 ta so'rov

API Endpoints

GET/api/mkb10

Kodlarni qidirish

MKB-10 kodlarini kod yoki nom bo'yicha qidirish

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'search'
Standart: search
qstring✓Qidiruv so'zi (kamida 2 ta belgi)
Min uzunlik: 2
limitinteger-Natijalar soni (maksimal 100)
Standart: 50
Maksimal: 100
min_similarityfloat-Minimal o'xshashlik foizi (0-100)
Standart: 25

Misol:

So'rov:
GET /api/mkb10?action=search&q=gastrit&limit=10
Javob:
{
    "success": true,
    "data": {
        "query": "gastrit",
        "total": 3,
        "results": [
            {
                "id": 287,
                "code": "K29",
                "name_uz": "Gastrit va duodenit",
                "name_ru": "Гастрит и дуоденит",
                "parent_code": "K20-K31",
                "is_category": 1,
                "similarity": 85.5,
                "match_field": "name_uz",
                "url": "\/category\/K29"
            }
        ]
    }
}
GET/api/mkb10

Kod bo'yicha ma'lumot olish

Bitta MKB-10 kodi haqida to'liq ma'lumot

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'code'
Standart: code
codestring✓MKB-10 kodi (masalan: K29)

Misol:

So'rov:
GET /api/mkb10?action=code&code=K29
Javob:
{
    "success": true,
    "data": {
        "id": 287,
        "code": "K29",
        "name_uz": "Gastrit va duodenit",
        "name_ru": "Гастрит и дуоденит",
        "parent_code": "K20-K31",
        "is_category": 1,
        "parent": {
            "code": "K20-K31",
            "name_uz": "Qizilo'ngach, oshqozon va o'n ikki barmoqli ichak kasalliklari",
            "name_ru": "Болезни пищевода, желудка и двенадцатиперстной кишки"
        },
        "children": [
            {
                "code": "K29.0",
                "name_uz": "O'tkir gemorragik gastrit",
                "name_ru": "Острый геморрагический гастрит"
            }
        ]
    }
}
GET/api/mkb10

Kategoriya elementlarini olish

Kategoriyaga tegishli barcha kodlarni olish

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'category'
Standart: category
codestring✓Kategoriya kodi (masalan: K20-K31)

Misol:

So'rov:
GET /api/mkb10?action=category&code=K20-K31
Javob:
{
    "success": true,
    "data": {
        "category": {
            "code": "K20-K31",
            "name_uz": "Qizilo'ngach, oshqozon va o'n ikki barmoqli ichak kasalliklari"
        },
        "items": [
            {
                "code": "K20",
                "name_uz": "Ezofagit"
            },
            {
                "code": "K21",
                "name_uz": "Gastroezofageal reflyuks kasalligi"
            }
        ],
        "total": 12
    }
}
GET/api/mkb10

Barcha kategoriyalar

Asosiy kategoriyalar ro'yxatini olish

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'categories'
Standart: categories

Misol:

So'rov:
GET /api/mkb10?action=categories
Javob:
{
    "success": true,
    "data": {
        "categories": [
            {
                "code": "A00-B99",
                "name_uz": "Yuqumli va parazitar kasalliklar"
            }
        ],
        "total": 22
    }
}
GET/api/mkb10

Kod ierarxiyasi

Kodning to'liq ierarxik yo'lini olish

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'hierarchy'
Standart: hierarchy
codestring✓MKB-10 kodi

Misol:

So'rov:
GET /api/mkb10?action=hierarchy&code=K29.0
Javob:
{
    "success": true,
    "data": {
        "hierarchy": [
            {
                "code": "K00-K93",
                "name_uz": "Ovqat hazm qilish tizimi kasalliklari"
            },
            {
                "code": "K20-K31",
                "name_uz": "Qizilo'ngach, oshqozon va o'n ikki barmoqli ichak kasalliklari"
            },
            {
                "code": "K29",
                "name_uz": "Gastrit va duodenit"
            },
            {
                "code": "K29.0",
                "name_uz": "O'tkir gemorragik gastrit"
            }
        ],
        "depth": 4
    }
}
GET/api/mkb10

Mashhur kodlar

Eng ko'p ko'rilgan va qidirilgan kodlar

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'popular'
Standart: popular
limitinteger-Natijalar soni (maksimal 50)
Standart: 10
Maksimal: 50

Misol:

So'rov:
GET /api/mkb10?action=popular&limit=5
Javob:
{
    "success": true,
    "data": {
        "popular": [
            {
                "code": "J06",
                "name_uz": "Yuqori nafas yo'llari o'tkir infeksiyalari",
                "view_count": 2134,
                "search_count": 1456,
                "popularity_score": 5046
            }
        ],
        "total": 5
    }
}
GET/api/mkb10

Statistika

Ma'lumotlar bazasi statistikasi

Parametrlar:

NomTuriMajburiyTavsif
actionstring✓Amal turi. Qiymat: 'stats'
Standart: stats

Misol:

So'rov:
GET /api/mkb10?action=stats
Javob:
{
    "success": true,
    "data": {
        "total_codes": 10250,
        "total_categories": 367,
        "by_letter": [
            {
                "letter": "A",
                "count": 543
            },
            {
                "letter": "B",
                "count": 412
            }
        ]
    }
}

Xatoliklar

KodXabarMisol
400Noto'g'ri so'rov{"success":false,"error":"Query must be at least 2 characters long"}
404Ma'lumot topilmadi{"success":false,"error":"Code not found"}
500Server xatoligi{"success":false,"error":"Database error occurred"}

Foydalanish misollari

JavaScript/Fetch

fetch('https://xkt-10.vena.uz/api/mkb10?action=search&q=gastrit')
  .then(response => response.json())
  .then(data => {
    console.log(data.data.results);
  });

PHP/cURL

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://xkt-10.vena.uz/api/mkb10?action=search&q=gastrit');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Python/requests

import requests

response = requests.get('https://xkt-10.vena.uz/api/mkb10', 
    params={'action': 'search', 'q': 'gastrit'})
data = response.json()

Ko'p beriladigan savollar

API orqali siz MKB-10 ma'lumotlarini o'z dasturingizga osongina integratsiya qilishingiz mumkin. Bu tibbiy dasturlar, klinika tizimlari va boshqa loyihalar uchun foydali.

Ha, API to'liq bepul va ochiq. Hech qanday to'lov yoki ro'yxatdan o'tish talab qilinmaydi.

Daqiqasiga 100 tagacha so'rov yuborishingiz mumkin. Bu ko'pchilik loyihalar uchun yetarli.

API barcha javoblarni JSON formatida qaytaradi. Bu zamonaviy dasturlarda eng ko'p qo'llaniladigan format.

Albatta! API CORS-ni qo'llab-quvvatlaydi, shuning uchun istalgan platformadan foydalanishingiz mumkin.