HTTP error codes

Introduction

The TraceParts APIs returns appropriate HTTP status codes for every request. If this request encounters an error, a response with the HTTP status codes and the corresponding error message will be displayed.

Description

The table lists the errors returned when working with TraceParts APIs. Some errors are resolved if you simply retry the same request. The table indicates which errors are likely to be resolved with successive retries. If the “Retry” column contains a “Y”, please submit the same request again. If the “Retry” column contains an “N”, please fix the problem in your call before submitting a new request.

Response Status Codes

HTTP Status Code

Description

Retry

400

A parameter is missing in the call

N

403

The request has been refused or access is not allowed. Check you API key

N

404

The provided item does not exist

N

408

The request timed out

Y

500

Internal server error

N

503

The API rate-limit has been reached

Y

HTTP error codes response

JSON Output

A sample HTTP request is shown below, displaying that a CAD format doesn’t exist.

{
"codeError":"404",
"messageError":"CAD(99) not found"
}

XML Output

Same example as above.

<Error>
<CodeError>404</CodeError>
<MessageError>CAD(99) not found</MessageError>
</Error>

HTTP error codes response elements

HTTP error codes response contains two elements:

  • “CodeError”: HTTP error code.
  • “MessageError”: Description of the error.

Last updated June 30, 2015