EDI 제약사 분류

처방·EDI 통계 이미지를 올리면 약품코드를 읽어 어느 제약사 약인지 자동으로 분류해 드립니다. 여러 제약사 약이 섞여 있어도 코드 기준으로 나눠 주고, 코드가 없는 문서는 약품명으로 후보 제약사를 추려 검수 시간을 줄여 줍니다. 자동 인식이라 문서 상태(사진 선명도·양식)에 따라 결과가 완벽하지 않을 수 있으니, 중요한 건은 확인을 권장합니다.

바로 실행

이 API 데모는 로그인 후 이용할 수 있습니다.

처방·EDI 통계 이미지를 올리면 약품코드(9자리)를 읽어 제약사로 자동 분류합니다. 한 문서에 여러 제약사가 섞여 있어도 제약사별로 코드를 묶어 반환합니다. 코드가 인쇄되지 않은 문서는 약품명으로 후보 제약사를 추려 줍니다(검수용).

엔드포인트

POST https://marketapi.nadoo.ai/api/v1/edi-classify/classify

인증

요청 본문 (JSON)

응답 200 OK

응답 예시

{
  "requestId": "3f9a1c2e-...",
  "imageId": "b6eef39918",
  "docType": "edi",
  "manufacturers": [
    { "name": "(유)한풍제약", "codes": ["658106350", "658106760"] },
    { "name": "(주)유한양행", "codes": ["642101080"] }
  ],
  "candidates": ["건일바이오팜(주)"],
  "cost": { "krw": 70, "free": false },
  "balanceKrw": 49950
}

비-EDI 문서는 { "docType": "non_edi", "rejected": true, "refunded": true, ... }로 반환되며 과금되지 않습니다.

에러 응답

예시 (cURL)

curl -X POST https://marketapi.nadoo.ai/api/v1/edi-classify/classify \
  -H "x-api-key: pk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"image":"<base64>"}'

배치 처리 (여러 장)

여러 이미지를 한 번에 처리합니다. 항목별로 독립 과금되며(성공 70원/건, 비-EDI·실패는 자동 환불), 부분 성공을 지원합니다. 각 이미지는 images(base64) 또는 imageUrls로 전달하며, 대량·대용량은 아래 presigned 업로드 + imageUrls를 권장합니다.

대용량 업로드 (presigned, 권장)

base64는 요청 크기 한계(본문 25MB·원본 ~18MB)가 있어, 대용량·대량은 presigned 업로드가 안정적입니다(용량 무제한 — 이미지를 GCS로 직접 PUT).① 업로드 URL 발급 → ② 이미지 PUT → ③ imageUrl 로 분류. (contentType은 image/jpeg·png·webp만 허용, 그 외 415.)

# ① 업로드 URL 발급
curl -X POST https://marketapi.nadoo.ai/api/v1/uploads \
  -H "x-api-key: pk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"contentType":"image/jpeg"}'
# → { "uploadUrl": "https://storage.googleapis.com/...(서명)", "imageUrl": "https://.../key", "expiresIn": 900 }

# ② 이미지를 uploadUrl 로 PUT (같은 Content-Type)
curl -X PUT "<uploadUrl>" -H "Content-Type: image/jpeg" --data-binary @처방전.jpg

# ③ imageUrl 로 분류(단건·배치 공통)
curl -X POST https://marketapi.nadoo.ai/api/v1/edi-classify/classify -H "x-api-key: pk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"imageUrl":"<imageUrl>"}'

동기 POST /api/v1/edi-classify/classify-batch

이미지 배열을 즉시 처리해 전체 결과를 반환합니다(최대 30장). 본문 { images: base64[] } 또는 { imageUrls: string[] }.

{
  "total": 3, "done": 3, "ok": 2, "failed": 0,
  "totalCostKrw": 140, "balanceKrw": 49900,
  "results": [
    { "index": 0, "status": "ok", "docType": "edi",
      "manufacturers": [{ "name": "(유)한풍제약", "codes": ["658106350"] }] },
    { "index": 1, "status": "ok", "docType": "non_edi" },
    { "index": 2, "status": "ok", "docType": "edi", "candidates": ["건일바이오팜(주)"] }
  ]
}

비동기 POST /api/v1/edi-classify/classify-batch-async

대량용(최대 500장). 접수 즉시 202로 작업 정보를 반환하고, 처리는 백그라운드(큐)에서 진행됩니다. 본문은 동기와 동일(images / imageUrls — 대량은 presigned imageUrls 권장).

작업 폴링 GET /api/v1/jobs/{jobId}

작업 진행 상태·결과를 조회합니다(본인 소유만). status가 종료 상태가 될 때까지 폴링하세요.

응답은 jobId·status·total·done·ok·failed·totalCostKrw와 results[](동기 배치와 동일 스키마)를 포함합니다.

# ① 접수
curl -X POST https://marketapi.nadoo.ai/api/v1/edi-classify/classify-batch-async \
  -H "x-api-key: pk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"imageUrls":["https://.../a.jpg","https://.../b.jpg"]}'
# → { "jobId": "job_abc", "status": "queued", "total": 2, "pollUrl": "/api/v1/jobs/job_abc" }

# ② 폴링(status 가 done/partial/failed 될 때까지 반복)
curl https://marketapi.nadoo.ai/api/v1/jobs/job_abc -H "x-api-key: pk_live_xxxxxxxx"
# → { "jobId": "job_abc", "status": "done", "total": 2, "done": 2, "ok": 2, "failed": 0,
#     "totalCostKrw": 140,
#     "results": [ { "index": 0, "status": "ok", "docType": "edi", "manufacturers": [...] }, ... ] }