시작하기

에러 코드

실패는 언제나 같은 모양으로 돌아옵니다.

형식

HTTP 상태 코드와 함께 error.code 가 옵니다. 분기는 code 로 하세요 — message 는 사람이 읽는 문장이라 문구가 바뀔 수 있습니다.

code	상태	언제
`no_file`	400	파일을 보내지 않았습니다
`file_count`	400	파일 개수가 도구의 min·max 를 벗어났습니다
`bad_ext`	400	도구가 받지 않는 확장자입니다
`empty_file`	400	크기가 0인 파일이 있습니다
`too_big`	413	파일 하나가 한도(200MB)를 넘었습니다
`empty_text`	400	글자 입력이 비었습니다
`missing_option`	400	필수 옵션이 비었습니다
`bad_option`	400	옵션 값이 정의된 범위·목록 밖입니다
`bad_range`	400	문서에 없는 쪽 번호나 범위를 지정했습니다
`bad_size`	400	너비·높이를 둘 다 비웠습니다
`empty_result`	400	지정대로 처리하면 남는 쪽이 없습니다
`weak_password`	400	암호가 4자 미만입니다
`bad_content_type`	415	multipart 도 JSON 도 아닙니다
`bad_body`	400	JSON 본문을 해석하지 못했습니다
`not_found`	404	없는 도구 id 입니다
`expired`	410	결과 보관 시간이 지났습니다
`encrypted`	422	암호가 걸린 PDF 라 열 수 없습니다
`bad_password`	422	암호가 맞지 않습니다
`bad_zip`	422	ZIP 을 읽지 못했습니다
`empty_zip`	422	ZIP 안에 파일이 없습니다
`process_failed`	422	파일이 손상됐거나 지원하지 않는 형식입니다
`segmentation_failed`	422	배경을 가려내지 못했습니다
`tool_unavailable`	503	이 서버에 그 도구의 변환 엔진이 없습니다
`dependency_missing`	503	변환 엔진 실행 파일을 찾지 못했습니다
`hwp_filter_missing`	503	HWP 변환기가 설치돼 있지 않습니다
`font_missing`	503	서버에 한글 폰트가 없어 글자를 그릴 수 없습니다
`timeout`	504	처리가 300초를 넘었습니다
`internal`	500	위 어디에도 속하지 않는 실패입니다

실패 응답

{
  "ok": false,
  "error": {
    "code": "bad_range",
    "message": "3쪽 문서에 없는 쪽 번호다: 9"
  }
}

형식

목록