{"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_identi3":{"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},"pass_num":{"type":"string","description":"여권번호입니다. 예: M12345678."},"made_date":{"type":"string","description":"발급일 YYYYMMDD입니다."},"exp_date":{"type":"string","description":"기간만료일 YYYYMMDD입니다."},"birth_date":{"type":"string","description":"생년월일 YYYYMMDD입니다."},"pass_code":{"type":"string","description":"여권 하단 기계판독영역(두 줄 중 둘째 줄) 문자열입니다. 여권번호·국적·생년월일·만료일이 담겨 있어 다른 항목을 검증할 때 씁니다."}}},"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"}}}}