의약품 정보 검색 v1.0

식품의약품안전처 · 의약품 제품 허가정보 · Dr. Portal
홈으로
Dr. mediforce · Dr. mediforce
⚠ 서비스키 미설정
A. 딥링크
B. 약제 검색
⭐ E. 약제 요약
📋 API 상세

A의약품안전나라 딥링크

약제명·표준코드로 의약품안전나라 검색결과를 열거나, itemSeq로 상세페이지에 직접 이동합니다. (API 키 불필요)
⭐ 직접 상세페이지 이동: itemSeq(품목기준코드 9자리)로 검색 단계 없이 상세페이지로 직행합니다.
버튼 클릭 시 해당 URL이 새 탭에서 열립니다.

B약제 검색 (의약품 제품 허가정보)

승인 API: DrugPrdtPrmsnInfoService07/getDrugPrdtPrmsnInq07
약제명 일부만 입력해도 조회 가능. 결과 항목에서 📑 요약화면 또는 📖 상세페이지로 이동할 수 있습니다.
서비스키 설정 후 검색어를 입력하고 "검색"을 누르세요.
🔧 요청 URL / 원본 JSON

E약제 요약 화면

itemSeq 입력 → 상세조회 API(getDrugPrdtPrmsnDtlInq06) 한 번 호출 →
① 효능·효과 · ② 용법·용량 · ③ 경고 · ④ 절대 금기 · ⑤ 일반 주의사항 을 XML 파싱하여 구조화 표시.
⚠ DUR 정보 (병용금기/연령금기/임부금기 등)는 별도 API(DURPrdlstInfoService03) 활용신청이 필요합니다. 현재 본 페이지에서는 미표시 항목입니다.
e약은요 활용신청 · 공공데이터포털
itemSeq를 입력 후 "요약 가져오기"를 누르세요.

D이용 API 상세

상세페이지 직접링크 패턴

직접 상세링크https://nedrug.mfds.go.kr/pbp/CCBBB01/getItemDetail?itemSeq={itemSeq}
예시itemSeq=202100467 → 페이지 열기 (렉라자정 · 유한양행)

✅ 승인 API: 의약품 제품 허가정보 (DrugPrdtPrmsnInfoService07)

Base URLhttps://apis.data.go.kr/1471000/DrugPrdtPrmsnInfoService07
목록 조회getDrugPrdtPrmsnInq07 — 약제명 검색
상세 조회getDrugPrdtPrmsnDtlInq06 — itemSeq로 단건 조회 · 요약화면 핵심
파라미터serviceKey, item_name, item_seq, type=json
상세 주요 필드 ITEM_SEQ, ITEM_NAME, ENTP_NAME, ETC_OTC_CODE, BAR_CODE, MATERIAL_NAME, MAIN_ITEM_INGR, ATC_CODE, STORAGE_METHOD, VALID_TERM, PACK_UNIT
XML 문서 (요약화면 소스):
EE_DOC_DATA — 효능효과 XML
UD_DOC_DATA — 용법용량 XML
NB_DOC_DATA — 사용상의 주의사항 XML (일반용 — 경고 / 투여금기 / 일반주의 / 상호작용 / 부작용 포함)
PN_DOC_DATA — 사용상의 주의사항 XML (전문가용)
EE_DOC_ID / UD_DOC_ID / NB_DOC_ID — 원문 PDF 다운로드 URL
일일 트래픽10,000 건 (승인받은 계정 기준)

XML 구조 (EE/UD/NB_DOC_DATA 공통)

<DOC title="효능효과|용법용량|사용상의주의사항" type="EE|UD|NB">
  <SECTION title="">
    <ARTICLE title="1. 경고">
      <PARAGRAPH><![CDATA[ 본문... ]]></PARAGRAPH>
      <PARAGRAPH>...</PARAGRAPH>
    </ARTICLE>
    <ARTICLE title="2. 다음 환자에는 투여하지 말 것"> ← 절대금기
    <ARTICLE title="3. 다음 환자에는 신중히 투여할 것"> ← 신중투여
    <ARTICLE title="4. 이상반응">
    <ARTICLE title="5. 일반적 주의">
  </SECTION>
</DOC>

CORS 지원

엔드포인트CORS비고
apis.data.go.kr (HTTPS)✓ 허용브라우저 직접 호출 가능 (본 페이지 동작 방식)
nedrug.mfds.go.kr✖ 차단딥링크로 새 탭 이동만 가능

보안 운영 권장 (다중 사용자 시)

┌──────────┐   HTTPS    ┌──────────────┐   HTTPS   ┌─────────────────┐
│ 브라우저  │ ─────────→ │ 자체 서버     │ ────────→ │ apis.data.go.kr │
│ (환자/의사)│            │ (프록시+캐시) │           │ (식약처)         │
└──────────┘            └──────────────┘           └─────────────────┘

→ 서비스키는 서버에만 보관 (보안)
→ 캐싱으로 일일 10,000 쿼터 절감
→ XML 파싱도 서버에서 수행 후 JSON으로 전달

단일 사용자(원장 1인) 환경에서는 본 정적 페이지(localStorage 키 보관)로 충분합니다. 다중 사용자/외부 공개 시 위 아키텍처를 권장합니다.