Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated 900901 description.

...

Given below are some error codes and their meanings.

API handlers error codes

...

Error codeError MessageDescriptionExample
700700
API blockedThis API has been blocked temporarily. Please try again later or contact the system administrators.Invoke an API in the BLOCKED lifecycle state.
900800
Message throttled outThe maximum number of requests that can be made to the API within a designated time period is reached and the API is throttled for the user.Invoke an API exceeding the tier limit.
900801
Hard limit exceededHard throttle limit has been reached.
Invoke an API exceeding the hard throttle limit
When the access token is invalid or inactive.
900802Resource level throttle outMessage is throttled out because resource level has exceeded.Sending/Receiving messages beyond authorized resource level.
900803Application level throttle outMessage is throttled out because application level is exceeded.Sending/Receiving messages beyond authorized application level.
900900

Unclassified authentication failure

An unspecified error has occurred.Backend service for key validation is not accessible when trying to invoke an API
900901

Invalid credentials

Invalid authentication information provided.Using an older access token after an access token has been renewed.
900902

Missing credentials

No authentication information provided.Accessing an API without the
900804Subscription level throttled outMessage throttled out due to subscription level throttling limit reached.Sending/Receiving messages beyond configured throttling limit of subscription level policy.
900805Message blockedAccessing an API which is blocked on user, IP, application, or API Context.An admin user can block API invocations in real time by user, IP, application, or API context. The API invocation meets the blocked condition.
900806Custom policy throttled outMessage throttled out due to exceeding the limit configured through the custom throttling policy rules.The API invocations meet custom throttle policy rules, exceeding the limits of the configured custom policy.
900807Message throttled outMessaged throttled out because of exceeding the burst control/rate limit (requests per second) in the subscription level policy.Sending/Receiving messages exceeding the configured burst control/rate limit within second.
900900

Unclassified authentication failure

An unspecified error has occurredBackend service for key validation is not accessible when trying to invoke an API
900901

Invalid credentials

Invalid authentication information provided

Note

The error codes 900903 (Access token expired) and 900904 (Access token inactive) are deprecated from API Manager 1.9.0 onwards. Alternatively, error code 900901 will be sent when the token is invalid or inactive.

When the access token is invalid or inactive.
900902

Missing credentials

No authentication information providedAccessing an API without Authorization: Bearer header
900905

Incorrect access token type is provided

The access token type used is not supported when invoking the API. The supported access token types are application and user accesses tokens. See Access Tokens.

Invoke an API with application token, where the resource only allows application user tokens.
900906

No matching resource found in the API for the given request

A resource with the name in the request can not be found in the API.Invoke an API resource that is not available.
900907

The requested API is temporarily blocked

Happens when the API user is blocked.Invoke API resource with a subscription that has been blocked by the API publisher.
900908

Resource forbidden

The user invoking the API has not been granted access to the required resource.Invoke an unsubscribed API.
900909

The subscription to the API is inactive

The status of the API has changed to an inaccessible/unavailable state.Invoke an API resource with a subscription that has not yet been approved by the administrator.
900910

The access token does not allow you to access the requested resource

Can not access the required resource with the provided access token. Check the valid resources that can be accessed with this token.

Invoke an API resource with an access token that is not
generated to be used with the resource's scope102511Incomplete payloadThe payload sent with the request is too large and the client is unable to keep the connection alive until the payload is completely transferred to the API GatewaySending a large PDF file with the POST request

...

generated to be used with the resource's scope.
102511Incomplete payloadThe payload sent with the request is too large and the client is unable to keep the connection alive until the payload is completely transferred to the API GatewaySending a large PDF file with the POST request.


Sequences error codes

Error codeDescription
900901
Production/sandbox key offered to the API with no production/sandbox endpoint.
400
Server cannot process the request due to an error in the request sent by the client.
403
No matching resource found in the API for the given request.

...

Info

The HTTP Status Codes and the corresponding error codes from the error responses are given below.

HTTP Status CodeError Code
400102511
401900901, 900902, 900905, 900907, 900909
403900906, 900908, 900910
429900800, 900802 900802, 900803, 900804, 900805, 900806, 900807
500900900
503700700, 900801

Transport error codes

Error CodeDetail
101000Receiver input/output error sending
101001Receiver input/output error receiving
101500Sender input/output error sending
101501Sender input/output error receiving
101503Connection failed
101504Connection timed out (no input was detected on this connection over the maximum period of inactivity)
101505Connection closed
101506NHTTP protocol violation
101507

Connection canceled

101508Request to establish new connection timed out
101509Send abort
101510Response processing failed

...


Error code = Base error code + Protocol State


There is a machine state machine in the transport sender side, where the protocol state changes according to the phase of the message.

...