Files

시골약사 659e9d5880 docs: 약학정보원 JSON API 정답 경로 추가 (로컬 BLOB 우회 해법)

다른 AI가 로컬 BLOB(DrugImg) 매칭키에서 막힌 부분을, 운영 POS에
실제 구현·검증한 약정원 JSON API 경로로 보강. 혼동 방지용 결정 문서.

- docs/healthkr-json-api-SOLVED.md: 정답 경로 단일 진입점.
  · 연결고리 = CD_GOODS.BARCODE → CD_BARCODE.DIK_CODE (CD_GOODS.DIK
    직접 14/19, 바코드 경로 18/19. 용각산(대) 실증).
  · 정답 엔드포인트 = ajax_result_drug2.asp (JSON 64필드+이미지URL).
    result_drug_simple.asp는 사람용 HTML, zoom.asp 파싱 불필요.
  · 로컬 BLOB 안 씀 → 44자 base64 image key 문제 자체가 사라짐.
- README: 핵심결론 최상단에 SOLVED 문서 포인터.
- scripts/probe_healthkr_json.py: 정답 경로 재현 스크립트(비번 CHANGEME).

기존 drugimg-key-findings.md(BLOB 분석)는 보존 — "BLOB 쓸 때의 문제"로
관계 명시.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-29 10:22:26 +09:00

4.4 KiB

Raw Blame History

★해결: 약학정보원(health.kr) JSON API로 약품정보+이미지 가져오기

이 문서는 실제 운영 POS(ANIPOS)에 구현·배포된 정답 경로입니다. 로컬 BLOB(PM_IMAGE..DrugImg) 매칭키 분석(drugimg-key-findings.md)은 "암호화 image key라 어렵다"에서 멈췄지만 — 애초에 로컬 BLOB을 쓸 필요가 없습니다. 약품 이미지·상세정보는 약학정보원 JSON API에서 평문 DIK_CODE로 안정적으로 받습니다. 실측 환경: 192.168.0.69\PM2014 (PIT3000), 검증일 2026-06-29.

TL;DR — 다른 AI는 이것만 보면 됨

POS 상품(DrugCode 또는 바코드)
  → PM_DRUG..CD_GOODS.BARCODE          (마스터 바코드)
  → PM_DRUG..CD_BARCODE.DIK_CODE       ★연결고리는 여기 (CD_GOODS.DIK_CODE 아님)
  → health.kr drug_cd = 평문 DIK_CODE
  → https://health.kr/searchDrug/ajax/ajax_result_drug2.asp?drug_cd={DIK}
  → JSON 배열 [{...64필드...}] : 약품명/성분/효능/이미지URL 전부

로컬 BLOB(DrugImg) 안 씀. 44자 base64 image key 푸는 노력 불필요.
직접 이미지 URL 추측 금지. big3/{DIK}.jpg는 대부분 404 — JSON 안의 이미지 필드를 써야 함.

★핵심 함정 1 — DIK_CODE 출처는 CD_BARCODE

판매상세/장바구니의 시작점은 DrugCode(예 LB000000169, ZP00000178, 조제약은 9자리). 거기서 DIK로 가는 경로 도달률 실측 (19개 샘플):

경로	도달	비고
A: `CD_GOODS.BARCODE → CD_BARCODE.DIK_CODE`	18/19 ✅ 정답
B: `CD_BARCODE.DRUGCODE` 직접 조인	0/19	CD_BARCODE.DRUGCODE엔 우리 DrugCode 없음
C: `CD_GOODS.DIK_CODE` 직접	14/19	LB채번 약 누락

실증: 용각산(대) LB000000169 = CD_GOODS.DIK_CODE = NULL(C 실패)인데 BARCODE 8806419031329 → CD_BARCODE.DIK = A11AJJJJJ0220(A 성공) → health.kr 이미지 exists=True. CD_GOODS.DIK 직접만 믿으면 이런 약이 통째로 빠진다.

SELECT TOP 1 b.DIK_CODE
FROM PM_DRUG..CD_GOODS g
JOIN PM_DRUG..CD_BARCODE b ON g.BARCODE = b.BARCODE
WHERE g.DrugCode = ? AND ISNULL(b.DIK_CODE,'') <> '';

CD_BARCODE.DIK_CODE 채움률 = 210,529 / 307,078 (69%) (CD_GOODS.DIK 44%보다 높음). 조제약(ETC)도 9자리 약품코드로 동일 경로 도달 9/10 (바코드 없는 약만 누락).

★핵심 함정 2 — 정답 엔드포인트는 ajax_result_drug2.asp (JSON)

사람용 HTML : https://health.kr/searchDrug/result_drug_simple.asp?drug_cd={DIK}
정답 JSON   : https://health.kr/searchDrug/ajax/ajax_result_drug2.asp?drug_cd={DIK}

응답 content-type은 text/html이지만 본문은 순수 JSON 배열(json.loads OK).
zoom.asp 파싱조차 불필요 — JSON에 이미지 URL이 직접 들어있다.
헤더에 Referer: https://health.kr/ 권장.

JSON 주요 필드 (64개 중)

필드	내용
`drug_name` / `drug_enm`	한글명 / 영문명
`upso_name`	`제조사\|영문\|주소\|전화\|...` (파이프 구분, 첫 토큰만)
`list_sunb_name`	성분
`cls_code`	약효분류 / `drug_form` 제형 / `charact` 성상
`boh`	보험/비급여
`effect`/`dosage`/`caution`/`mediguide`/`additives`	효능/용법/주의/복약지도/첨가제
`drug_pic` / `pack_img`	낱알/포장 이미지 URL (`common.health.kr/...`)
`picto_img`	픽토그램 URL들, `\|` 구분

⚠ 본문 텍스트(effect 등)는 줄바꿈을 리터럴 brbr / <P></P> / </br>로 섞어 줌 → <br>로 정리 필요. ⚠ 이미지 필드는 빈 값일 수 있음(약마다 커버리지 다름). URL은 실제 GET으로 image magic 확인 권장.

구현 (운영 반영됨)

pharmon-web POS에 구현·커밋(3c2481a):

healthkr_drug_info.py — extract_info(drugcode) / extract_many([...])(ThreadPool 병렬).
drug_info_dialog.py — 판매상세 상품명 더블클릭 → QTextBrowser 약품정보 카드 (QtWebEngine 미사용, 이미지 URL→QImage 인라인).
OTC·ETC 상세 둘 다 적용.

기존 BLOB 분석과의 관계

drugimg-key-findings.md의 결론(로컬 DrugImg.DIK_CODE가 44자 base64 image key라 join 단정 불가)은 맞다. 다만 그건 로컬 BLOB을 쓰려 할 때의 문제일 뿐이고, 우리는 로컬 BLOB을 안 쓰고 약정원 JSON API로 우회한다 → 그 문제 자체가 사라진다.

4.4 KiB Raw Blame History