🇺🇿 🇷🇺
Ctrl + K

Документация API

Документация API XKT-10.VENA.UZ и инструкции по использованию

RESTful API для кодов медицинской классификации МКБ-10

Версия: 1.0
Базовый URL: https://xkt-10.vena.uz/api/mkb10
Аутентификация: API ключ не требуется. Открытый API.
Ограничения: 100 запросов в минуту

API Endpoints

GET/api/mkb10

Поиск кодов

Поиск кодов МКБ-10 по коду или названию

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'search'
По умолчанию: search
qstring✓Поисковый запрос (минимум 2 символа)
Мин длина: 2
limitinteger-Количество результатов (максимум 100)
По умолчанию: 50
Максимум: 100
min_similarityfloat-Минимальный процент схожести (0-100)
По умолчанию: 25

Пример:

Запрос:
GET /api/mkb10?action=search&q=гастрит&limit=10
Ответ:
{
    "success": true,
    "data": {
        "query": "гастрит",
        "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_ru",
                "url": "\/category\/K29"
            }
        ]
    }
}
GET/api/mkb10

Получение информации по коду

Полная информация об одном коде МКБ-10

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'code'
По умолчанию: code
codestring✓Код МКБ-10 (например: K29)

Пример:

Запрос:
GET /api/mkb10?action=code&code=K29
Ответ:
{
    "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

Получение элементов категории

Получить все коды, принадлежащие категории

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'category'
По умолчанию: category
codestring✓Код категории (например: K20-K31)

Пример:

Запрос:
GET /api/mkb10?action=category&code=K20-K31
Ответ:
{
    "success": true,
    "data": {
        "category": {
            "code": "K20-K31",
            "name_ru": "Болезни пищевода, желудка и двенадцатиперстной кишки"
        },
        "items": [
            {
                "code": "K20",
                "name_ru": "Эзофагит"
            },
            {
                "code": "K21",
                "name_ru": "Гастроэзофагеальная рефлюксная болезнь"
            }
        ],
        "total": 12
    }
}
GET/api/mkb10

Все категории

Получить список основных категорий

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'categories'
По умолчанию: categories

Пример:

Запрос:
GET /api/mkb10?action=categories
Ответ:
{
    "success": true,
    "data": {
        "categories": [
            {
                "code": "A00-B99",
                "name_ru": "Некоторые инфекционные и паразитарные болезни"
            }
        ],
        "total": 22
    }
}
GET/api/mkb10

Иерархия кода

Получить полный иерархический путь кода

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'hierarchy'
По умолчанию: hierarchy
codestring✓Код МКБ-10

Пример:

Запрос:
GET /api/mkb10?action=hierarchy&code=K29.0
Ответ:
{
    "success": true,
    "data": {
        "hierarchy": [
            {
                "code": "K00-K93",
                "name_ru": "Болезни органов пищеварения"
            },
            {
                "code": "K20-K31",
                "name_ru": "Болезни пищевода, желудка и двенадцатиперстной кишки"
            },
            {
                "code": "K29",
                "name_ru": "Гастрит и дуоденит"
            },
            {
                "code": "K29.0",
                "name_ru": "Острый геморрагический гастрит"
            }
        ],
        "depth": 4
    }
}
GET/api/mkb10

Популярные коды

Самые просматриваемые и искомые коды

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'popular'
По умолчанию: popular
limitinteger-Количество результатов (максимум 50)
По умолчанию: 10
Максимум: 50

Пример:

Запрос:
GET /api/mkb10?action=popular&limit=5
Ответ:
{
    "success": true,
    "data": {
        "popular": [
            {
                "code": "J06",
                "name_ru": "Острые инфекции верхних дыхательных путей",
                "view_count": 2134,
                "search_count": 1456,
                "popularity_score": 5046
            }
        ],
        "total": 5
    }
}
GET/api/mkb10

Статистика

Статистика базы данных

Параметры:

НазваниеТипОбязательныйОписание
actionstring✓Тип действия. Значение: 'stats'
По умолчанию: stats

Пример:

Запрос:
GET /api/mkb10?action=stats
Ответ:
{
    "success": true,
    "data": {
        "total_codes": 10250,
        "total_categories": 367,
        "by_letter": [
            {
                "letter": "A",
                "count": 543
            },
            {
                "letter": "B",
                "count": 412
            }
        ]
    }
}

Ошибки

КодСообщениеПример
400Неверный запрос{"success":false,"error":"Query must be at least 2 characters long"}
404Данные не найдены{"success":false,"error":"Code not found"}
500Ошибка сервера{"success":false,"error":"Database error occurred"}

Примеры использования

JavaScript/Fetch

fetch('https://xkt-10.vena.uz/api/mkb10?action=search&q=гастрит')
  .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=гастрит');
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': 'гастрит'})
data = response.json()

Часто задаваемые вопросы

С помощью API вы можете легко интегрировать данные МКБ-10 в свое приложение. Это полезно для медицинских программ, клинических систем и других проектов.

Да, API полностью бесплатный и открытый. Не требуется никакой оплаты или регистрации.

Вы можете отправлять до 100 запросов в минуту. Этого достаточно для большинства проектов.