POST/api/v1/biz-doc/bizdoc

사업자등록증 추출

사업자등록증 사진·PDF를 올리면 사업자등록번호·상호·대표자·업태·종목 등을 자동으로 읽어 드립니다. 국세청 상태조회로 폐업 여부까지 확인하고, 각 항목의 위치도 함께 표시해 검수가 쉽습니다.

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

바로 실행

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

사업자등록증 이미지·PDF 업로드

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

POST/api/v1/biz-doc/bizdoc

사업자등록증 이미지(JPG/PNG) 또는 PDF를 올리면 아래 항목을 값 + 위치(box_2d)로 반환합니다, 사업자등록번호 체크섬·국세청 상태조회까지 검증합니다. 업로드한 문서가 사업자등록증이(가) 아니면 wrong_document로 실제 유형을 판별해 안내합니다.

엔드포인트

POST https://marketapi.nadoo.ai/api/v1/biz-doc/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	`business-registration`
`fields[]`	array	`{ key, value, normalizedValue?, box_2d }` (box_2d=[ymin,xmin,ymax,xmax] 0~1000)
`validation`	object	`{ ok, issues[] }` — 체크섬·국세청·교차검증
`cost.krw`	number	이번 호출 과금액(원). 무료 제공량이면 0.

추출 필드 (사업자등록증)

key	항목	비고
`business_no`	사업자등록번호	체크섬·국세청 검증
`corp_no`	법인등록번호
`company_name`	상호
`ceo_name`	대표자
`open_date`	개업연월일	normalizedValue=YYYY-MM-DD
`address`	사업장소재지
`biz_type`	업태
`biz_item`	종목

예시

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

{
  "status": "extracted",
  "docType": "business-registration",
  "fields": [
    { "key": "business_no", "value": "405-07-36978" },
    { "key": "company_name", "value": "라온팜" },
    { "key": "open_date", "value": "2024-05-22", "normalizedValue": "2024-05-22" }
  ],
  "validation": { "ok": true, "issues": [ … ] },
  "cost": { "krw": 80 }
}

사업자등록증이(가) 아닌 문서 업로드 시 — 유형 판별은 과금:

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