{"openapi":"3.0.3","info":{"title":"사업자등록증 추출 API","version":"1.0.0","description":"사업자등록증 사진·PDF를 올리면 사업자등록번호·상호·대표자·업태·종목 등을 자동으로 읽어 드립니다. 국세청 상태조회로 폐업 여부까지 확인하고, 각 항목의 위치도 함께 표시해 검수가 쉽습니다."},"servers":[{"url":"https://marketapi.nadoo.ai"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/api/v1/biz-doc/bizdoc":{"post":{"summary":"사업자등록증 추출","description":"이미지(JPG/PNG)·PDF 바이너리 업로드 → 필드+box_2d+검증(체크섬·국세청). 사업자등록증이 아니면 wrong_document(자동 환불).","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"추출 성공(또는 반려 시 refunded)","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["extracted","wrong_document","not_found","too_large","too_many_pages"]},"docType":{"type":"string"},"detectedType":{"type":"string","nullable":true},"fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string","description":"원문"},"normalizedValue":{"type":"string","nullable":true,"description":"날짜 등 정규화(YYYY-MM-DD)"},"box_2d":{"type":"array","items":{"type":"number"},"description":"[ymin,xmin,ymax,xmax] 0~1000"}}}},"validation":{"type":"object","properties":{"ok":{"type":"boolean"},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"message":{"type":"string","nullable":true},"refunded":{"type":"boolean","nullable":true},"cost":{"type":"object","properties":{"krw":{"type":"number"}}}}}}}},"402":{"description":"무료 제공량 소진·잔액 부족"},"413":{"description":"본문 용량 초과(64MB)"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}}}