{"openapi":"3.0.3","info":{"title":"APICK 주민등록등본 텍스트 추출(OCR)","version":"1.0.0","description":"OCR(Optical Character Recognition) 주민등록등본 사진에서 주요 정보를 텍스트로 추출합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/ocr_identi4":{"post":{"summary":"주민등록등본 텍스트 추출(OCR)","description":"OCR(Optical Character Recognition) 주민등록등본 사진에서 주요 정보를 텍스트로 추출합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"object","properties":{"name":{"type":"string","description":"신청인 이름입니다. 찾지 못하면 null입니다.","nullable":true},"doc_num1":{"type":"string","description":"문서확인번호 첫째 묶음입니다. 예: 1234-5678-9012-3456이면 1234."},"doc_num2":{"type":"string","description":"문서확인번호 둘째 묶음입니다."},"doc_num3":{"type":"string","description":"문서확인번호 셋째 묶음입니다."},"doc_num4":{"type":"string","description":"문서확인번호 넷째 묶음입니다."},"type":{"type":"integer","description":"발급 종류입니다. 현재 항상 1입니다."}}},"raw_text":{"type":"string","description":"이미지에서 읽은 전체 텍스트입니다. 항목이 null일 때 직접 확인하는 용도로 씁니다."},"success":{"type":"integer","description":"1이면 판독 성공(과금)입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"분석할 이미지 파일입니다. JPG·PNG·WEBP를 지원하며, 파일 크기·해상도 제한은 요청 표를 확인하세요. (file)","format":"binary"}},"required":["image"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["첨부파일이 없습니다.","image 파일이 없습니다.","파일 필드 이름이 image인지 확인합니다."],["파일 유형이 맞지 않습니다. 이미지 형식의 파일만 허용됩니다.","이미지가 아닌 파일입니다.","JPG·PNG 이미지로 보냅니다."],["지원되지 않는 이미지 유형입니다. JPG 형태로 변환하여 재시도 해주세요.","읽을 수 없는 이미지 형식입니다.","JPG로 변환해 다시 보냅니다."],["알 수 없는 이유로 실패했습니다.","일시적인 실패입니다.","잠시 후 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}