카비네이터 공개 API

카비네이터 본 서비스가 쓰는 상병 검색/필터링 기능을, 여러분의 앱/스크립트에서 그대로 가져다 쓸 수 있는 외부 개발자용 API입니다. 현재 검색 1개 + 필터링 엔진 2개(근골격·외상 MST / 한방내과)가 열려 있습니다.

1. 개요

2. 상병 검색 — /api/kcd/public-search

검색어(상병코드 또는 상병명)를 넣으면, 관련도 순으로 정렬된 상병 목록을 최대 30건 반환합니다.

요청 파라미터

응답 필드

예제 요청 & 응답

요청: GET /api/kcd/public-search?q=요통&fields=0

{
  "query": "요통",
  "count": 29,
  "results": [
    { "code": "M54.5", "name": "요통", "claim_count": 13179873 },
    { "code": "M54.57", "name": "요통, 요천부", "claim_count": 13179873 },
    { "code": "M54.4", "name": "좌골신경통을 동반한 요통", "claim_count": 2303928 }
    // ... 이하 생략
  ]
}

코드로 호출하기

curl "https://kavinator.com/api/kcd/public-search?q=요통&fields=0"

fetch('https://kavinator.com/api/kcd/public-search?q=' + encodeURIComponent('요통') + '&fields=0')
  .then(res => res.json())
  .then(data => console.log(data));

import requests

res = requests.get(
    'https://kavinator.com/api/kcd/public-search',
    params={'q': '요통', 'fields': 0}
)
data = res.json()
print(data)

3. 근골격·외상 MST 필터 — /api/kcd/public-mst-filter

5대 대부위 → 발병기전(외상유무) → 세부분절 → 병변조직군 → 청구안전도 순으로 다차원 소거 필터링해 상병 후보군을 반환합니다. 모든 파라미터는 선택이며, 생략하면 해당 단계는 필터 없이 전체를 봅니다. 각 단계의 집계(*_summary)도 함께 내려가므로, 단계형(위저드) UI를 그대로 구현할 수 있습니다.

요청 파라미터

대부위(major) 코드표

세부분절(sub) 코드표

코드는 major를 지정하든 안 하든 항상 같은 값을 가리킵니다 — "소속 major" 열은 참고용입니다.

응답 필드

GET /api/kcd/public-mst-filter?major=2&sub=28

{
  "error": "sub 코드 '28'(다발·기타 외상 후유증)는 major=2(하지)에 속하지 않습니다. major=2에서 허용되는 sub 코드: 11=고관절·대퇴, 12=무릎·하퇴, 13=발목·발, 14=다리저림·좌골신경통(방사통)"
}

코드로 호출하기

curl "https://kavinator.com/api/kcd/public-mst-filter?major=1&trauma=NON_TRAUMA&tissue=MUSCLE&limit=5"

fetch('https://kavinator.com/api/kcd/public-mst-filter?' + new URLSearchParams({
  major: 1, trauma: 'NON_TRAUMA', tissue: 'MUSCLE', limit: 5
}))
  .then(res => res.json())
  .then(data => console.log(data));

import requests

res = requests.get(
    'https://kavinator.com/api/kcd/public-mst-filter',
    params={'major': 1, 'trauma': 'NON_TRAUMA', 'tissue': 'MUSCLE', 'limit': 5}
)
data = res.json()
print(data)

4. 한방내과 필터 — /api/kcd/public-internal-filter

7대 분과 → 청구안전도 → 세부분절 순으로 소거 필터링해 상병 후보군을 반환합니다.

요청 파라미터

분과(division) 코드표

세부분절(sub) 코드표

코드는 division을 지정하든 안 하든 항상 같은 값을 가리킵니다 — "소속 division" 열은 참고용입니다.

응답 필드

GET /api/kcd/public-internal-filter?division=1&sub=0

{
  "error": "sub 코드 '0'(구강·혀·턱)는 division=1(호흡기계)에 속하지 않습니다. division=1에서 허용되는 sub 코드: 7=코·비동, 8=인후·편도·후두, 9=기관지·기침, 10=폐·천식·COPD, 11=흉막·간질·기타"
}

코드로 호출하기

curl "https://kavinator.com/api/kcd/public-internal-filter?division=1&diag=CLINICAL&limit=5"

fetch('https://kavinator.com/api/kcd/public-internal-filter?' + new URLSearchParams({
  division: 1, diag: 'CLINICAL', limit: 5
}))
  .then(res => res.json())
  .then(data => console.log(data));

import requests

res = requests.get(
    'https://kavinator.com/api/kcd/public-internal-filter',
    params={'division': 1, 'diag': 'CLINICAL', 'limit': 5}
)
data = res.json()
print(data)

5. 직접 테스트해보기

여기에 응답 결과가 표시됩니다.

여기에 응답 결과가 표시됩니다.

여기에 응답 결과가 표시됩니다.

6. 이용 시 유의사항

이 API는 카비네이터 본 서비스와 같은 서버에서 무료로 제공됩니다. 과도한 트래픽이 발생하면 예고 없이 제한이 걸릴 수 있으니, 반복 호출이 필요한 경우 결과를 적절히 캐싱해서 사용해주시면 감사하겠습니다. 실제 환자 개인정보는 전혀 포함되지 않은 순수 상병마스터 데이터이므로 별도 개인정보 처리 방침은 적용되지 않습니다.

오류를 발견하셨거나, 더 필요한 파라미터/엔드포인트가 있다면 elaminus1@gmail.com으로 알려주세요.