{"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":{"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":{"text_coordinate":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string","description":"내용"},"vertices":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer","description":"x 좌표"},"y":{"type":"integer","description":"y 좌표"}}},"description":"꼭지점 좌표 리스트"}}},"description":"텍스트 좌표 리스트"},"full_text":{"type":"string","description":"전체 추출 결과"}},"description":"추출 결과"},"success":{"type":"integer","description":"과금 여부0: 실패1: 성공3: 실패(timeout)"}},"description":"조회 데이터"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"OCR_IMAGE_MISSING (400): 이미지 파일을 첨부하세요.\nOCR_UNSUPPORTED_IMAGE (400): 지원 이미지 형식을 사용하세요.\nOCR_IMAGE_TOO_LARGE (413): 50MB 이하 이미지를 사용하세요.\nOCR_NO_TEXT (422): 판독 가능한 글자가 없습니다. 선명한 이미지를 사용하세요.\nOCR_TIMEOUT (408): 처리 시간이 초과됐습니다. 이미지 크기와 품질을 확인하세요.\nOCR_CREDENTIALS_ERROR (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_CREDENTIALS_MISSING (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_UNAUTHORIZED (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_RATE_LIMITED (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_UPSTREAM_UNAVAILABLE (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_REQUEST_FAILED (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_EMPTY_RESPONSE (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"이미지 파일 (file)","format":"binary"}},"required":["image"]}}}}}}},"x-code-tables":[],"x-service-errors":[{"code":"OCR_IMAGE_MISSING","status":400,"message":"이미지 파일을 첨부하세요."},{"code":"OCR_UNSUPPORTED_IMAGE","status":400,"message":"지원 이미지 형식을 사용하세요."},{"code":"OCR_IMAGE_TOO_LARGE","status":413,"message":"50MB 이하 이미지를 사용하세요."},{"code":"OCR_NO_TEXT","status":422,"message":"판독 가능한 글자가 없습니다. 선명한 이미지를 사용하세요."},{"code":"OCR_TIMEOUT","status":408,"message":"처리 시간이 초과됐습니다. 이미지 크기와 품질을 확인하세요."},{"code":"OCR_CREDENTIALS_ERROR","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_CREDENTIALS_MISSING","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_UNAUTHORIZED","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_RATE_LIMITED","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_UPSTREAM_UNAVAILABLE","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_REQUEST_FAILED","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_EMPTY_RESPONSE","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}