POST/api/v1/cso-education/bizdoc

CSO 교육수료증 추출

CSO 교육수료증 사진·PDF를 올리면 성명·생년월일·소속·교육구분(신규/보수)·이수일·수료번호·발급기관을 자동으로 읽어 드립니다. 각 항목의 위치도 함께 표시해 검수가 쉽습니다.

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

바로 실행

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

CSO 교육수료증 이미지·PDF 업로드

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

POST/api/v1/cso-education/bizdoc

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

엔드포인트

POST https://marketapi.nadoo.ai/api/v1/cso-education/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-education`
`fields[]`	array	`{ key, value, normalizedValue?, box_2d }` (box_2d=[ymin,xmin,ymax,xmax] 0~1000)
`validation`	object	`{ ok, issues[] }`
`cost.krw`	number	이번 호출 과금액(원). 무료 제공량이면 0.

추출 필드 (교육수료증)

key	항목	비고
`person_name`	성명
`birth_date`	생년월일	normalizedValue=YYYY-MM-DD
`org_name`	소속
`course_type`	교육구분	신규(24h)/보수(8h)
`complete_date`	이수일	normalizedValue=YYYY-MM-DD
`cert_no`	수료번호
`issuer`	발급기관

예시

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

{
  "status": "extracted",
  "docType": "cso-education",
  "fields": [
    { "key": "person_name", "value": "전성문" },
    { "key": "course_type", "value": "신규" },
    { "key": "complete_date", "value": "2025-06-27", "normalizedValue": "2025-06-27" }
  ],
  "validation": { "ok": true, "issues": [ … ] },
  "cost": { "krw": 80 }
}

교육수료증이(가) 아닌 문서 업로드 시 — 유형 판별은 과금:

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