주의: 자세한 내용은 DeepL API 기술문서를 참조하시기 바랍니다. API 기술문서는 영어로만 제공됩니다.
오류 코드 예시
오류 400
잘못된 요청입니다. Please check error message and your parameters (잘못된 요청. 오류 메시지와 매개변수를 확인하세요)
이 오류는 요청의 필수 매개변수가 누락된 경우, 또는 지정된 매개변수 중 하나가 지원되지 않거나, 오타가 있거나, 값이 잘못된 경우 발생합니다.
오류 403
인증에 실패했습니다. Please supply a valid auth_key parameter (인증 실패. 유효한 auth_key 매개변수를 입력하세요)
이 오류는 요청에 API 키가 누락되었거나 올바르지 않을 때 발생합니다.
API 키가 유효하려면 구독이 활성화되어 있어야 합니다. DeepL 계정의 API 키 아래에서 API 키와 구독 상태를 확인할 수 있습니다.
또한 이용 중인 플랜에 원하는 서비스가 포함되어 있는지 알아보세요. DeepL API에 액세스하려면 DeepL API 플랜을 구독해야 합니다. CAT 툴의 인증 키는 DeepL Pro Advanced 및 DeepL Pro Ultimate 구독 플랜에 포함되어 있습니다 .
오류 404
요청한 리소스를 찾을 수 없습니다.
이 오류는 URL이 잘못된 경우 발생합니다. URL의 경로를 확인하세요.
오류 413
요청 크기가 제한을 초과합니다.
이 오류는 요청 크기가 지원되는 제한에 도달할 때 발생합니다.
문서 번역 등과 관련된 크기 제한 정보는 API 기술문서를 참조하세요.
많은 양의 텍스트를 번역하는 경우 단락 등으로 나누어 여러 번 요청하는 것을 고려해 보세요.
오류 414
요청-URI가 너무 깁니다.
이 오류는 API URL이 너무 긴 경우 웹 서버의 길이 제한으로 인해 발생합니다. GET 요청 대신 POST 요청을 사용하면 이 오류 메시지를 방지할 수 있습니다.
오류 429
요청이 너무 많습니다. 잠시 기다렸다가 요청을 다시 보내주세요.
이 메시지가 뜨면 잠시 기다렸다가 다시 시도하세요. 동일한 오류가 발생할 경우 대기 시간을 두 배로 늘리는 등 조금 더 기다렸다가 요청을 보내보세요. 요청이 성공적으로 처리될 때까지 이 과정을 반복합니다. 요청 처리에 성공하면 대기 시간을 조금씩 줄일 수 있습니다.
한 번에 처리하는 텍스트의 양을 줄이면 오류 발생 가능성을 낮출 수 있습니다.
오류 456
할당량이 초과되었습니다. The character limit has been reached (할당량 초과. 글자 수 제한에 도달했습니다)
이 오류는 글자 수 제한에 도달한 경우 발생합니다. DeepL 계정에서 비용 관리 설정을 확인하고 필요한 경우 한도를 늘리세요.
오류 5**
내부 오류
5로 시작하는 모든 오류는 내부 오류입니다. 오류 503이 발생하면 잠시 기다렸다가 나중에 다시 시도하세요. 기타 오류 발생 시 DeepL 지원팀에 문의하시기 바랍니다.