POST/api/v1/cso-report/bizdoc

CSO 판촉영업자 신고증 추출

의약품 판촉영업자(CSO) 신고증 사진·PDF를 올리면 신고번호·상호·대표자·영업소 소재지·신고일·관할관청을 자동으로 읽어 드립니다. 각 항목의 위치도 함께 표시해 검수가 쉽습니다.

무료 10회80원 / 페이지OpenAPI 스펙(JSON)

바로 실행

이미지를 올려 바로 실행해 결과를 확인하세요. (비로그인은 하루 실행 횟수 제한)

판촉영업자 신고증 이미지·PDF 업로드

클릭해서 파일을 선택하세요 (JPG/PNG/PDF). 비로그인은 하루 실행 횟수 제한이 있어요.

POST/api/v1/cso-report/bizdoc

판촉영업자 신고증 이미지(JPG/PNG) 또는 PDF를 올리면 아래 항목을 값 + 위치(box_2d)로 반환합니다. 업로드한 문서가 판촉영업자 신고증이(가) 아니면 wrong_document로 실제 유형을 판별해 안내합니다.

엔드포인트

POST https://marketapi.nadoo.ai/api/v1/cso-report/bizdoc

인증 · 요청

헤더	필수	설명
`x-api-key`	필수	대시보드 발급 API 키 (`pk_live_…`)
`Content-Type`	필수	`image/jpeg`·`image/png`·`application/pdf`
`Idempotency-Key`	선택	재시도 이중 과금 방지(권장 UUID).

요청 본문 = 파일 바이너리(base64 아님). 최대 64MB. 여러 문서가 묶인 PDF는 판촉영업자 신고증 페이지를 자동 탐지합니다.

응답 200 OK

필드	타입	설명
`status`	string	`extracted`(추출)·`wrong_document`(유형 판별) = 과금. `not_found`·`too_large`·`too_many_pages` = 자동 환불.
`docType`	string	`cso-report`
`fields[]`	array	`{ key, value, normalizedValue?, box_2d }` (box_2d=[ymin,xmin,ymax,xmax] 0~1000)
`validation`	object	`{ ok, issues[] }`
`cost.krw`	number	이번 호출 과금액(원). 무료 제공량이면 0.

추출 필드 (판촉영업자 신고증)

key	항목	비고
`report_no`	신고번호
`company_name`	상호
`ceo_name`	대표자
`address`	영업소소재지
`report_date`	신고연월일	normalizedValue=YYYY-MM-DD
`authority`	관할관청

예시

curl -X POST "https://marketapi.nadoo.ai/api/v1/cso-report/bizdoc" \
  -H "x-api-key: pk_live_..." \
  -H "Content-Type: image/jpeg" \
  --data-binary @document.jpg

{
  "status": "extracted",
  "docType": "cso-report",
  "fields": [
    { "key": "report_no", "value": "제 2024-4191050-00055 호" },
    { "key": "company_name", "value": "라온팜" },
    { "key": "report_date", "value": "2024-10-19", "normalizedValue": "2024-10-19" }
  ],
  "validation": { "ok": true, "issues": [ … ] },
  "cost": { "krw": 80 }
}

판촉영업자 신고증이(가) 아닌 문서 업로드 시 — 유형 판별은 과금:

{ "status": "wrong_document", "detectedType": "…",
  "message": "업로드하신 문서는 판촉영업자 신고증이(가) 아닙니다 (판별: …). …",
  "cost": { "krw": 80 } }