{"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_identi2":{"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},"birth_y":{"type":"string","description":"생년월일의 연도(4자리)입니다."},"birth_m":{"type":"string","description":"생년월일의 월(2자리)입니다."},"birth_d":{"type":"string","description":"생년월일의 일(2자리)입니다."},"rrn1":{"type":"string","description":"주민등록번호 앞 6자리입니다."},"rrn2":{"type":"string","description":"주민등록번호 뒤 7자리입니다."},"licen_no0":{"type":"string","description":"면허번호 첫째 묶음(지역 번호 2자리)입니다. 예: 11-23-123456-01이면 11."},"licen_no1":{"type":"string","description":"면허번호 둘째 묶음(2자리)입니다."},"licen_no2":{"type":"string","description":"면허번호 셋째 묶음(6자리)입니다."},"licen_no3":{"type":"string","description":"면허번호 넷째 묶음(2자리)입니다."},"ghost_num":{"type":"string","description":"면허증 사진 아래의 암호일련번호(영문·숫자 6자리 내외)입니다. 운전면허 진위확인에 함께 씁니다."}}},"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"}}}}