Error codes and messages
When you send Bing your Price feed to process, Bing may return one of the following HTTP status codes:
Status Code | Description |
---|---|
200 | Success. Bing successfully queued the message to be processed. |
401 | Unauthorized. The user is not authorized to use the API or the message was sent from an IP address that is unknown to Bing or that is not associated with the user. To determine the cause, see the error message. |
413 | Request entity too large. The Price feed must not exceed 100 MB or 10 MB compressed. |
429 | Too many requests. You may have a maximum of five requests queued or being processed at the same time. If you send a sixth request at this time, Bing returns this error. |
500 | Internal server error. This is typically a transient error. Retry the request at 1, 5, and 20 minute intervals. If the request fails after the third attempt, contact your TAM with the following information:
|
Response body
If an HTTP error occurs, the body of the response contains an XML document that contains a description of the error.
<ArrayOfApiError xmlns="http://schemas.datacontract.org/2004/07/Microsoft.BingAds.BHAC.HotelAdsAPIs.Models" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<ApiError>
<Code>IPAddressNotAllowed</Code>
<Message>Customer 4 is not authorized to use IP address 167.220.24.77.</Message>
<Property i:nil="true"/>
</ApiError>
</ArrayOfApiError>
The following tables describe the elements found in the error response.
Error Response
Defines the top-level element of an error response.
Element | Description | Children |
---|---|---|
ArrayOfApiError | The top-level element of an error response. This element contains a list of errors that occurred. | Array of ApiError |
ApiError
Defines an error that occurred.
Element | Description | Children |
---|---|---|
Code | A code that identifies the error that occurred. For example, IPAddressNotAllowed. | None |
Message | A message that describes the error that occurred. | None |
Property | The name of the property that caused the error. If the error is not related to a property, the element's nil attribute is set to true. |
None |
Codes and messages
The following lists the error codes and messages that the API returns.
Code | Message |
---|---|
AuthenticationFailure | Authentication failed for unknown reasons. |
InternalError | Internal server error. This is typically a transient error. Retry the request at 1, 5, and 20 minute intervals. If the request fails after the third attempt, contact your TAM with the following information:
|
IPAddressNotAllowed | Customer {custId} is not authorized to use IP address {clientIp}. The customer is not authorized to send Price feeds from the IP address. You must send the request from an authorized server IP address. Contact your TAM to update your list of authorized server IP addresses. |
NotAuthorized | The OAuth token that you set the Authorization header to is not valid. |
RequestThrottled | Customer {customerId} exceeded the number of requests allowed. Customers may have a maximum of five requests queued or being processed. Sending a sixth request in this case will fail. |
RequestTooLarge | The request size ({requestSizeBytes} bytes) exceeds the maximum allowed ({maxAllowed} bytes). The Price feed cannot exceed 100 MB or 10 MB compressed. Reduce the size of your Price feed to fit within the limits. |