Partilhar via

Códigos de erro e mensagens

  • Artigo

Quando envia o Feed de preços para o Bing para processar, o Bing pode devolver um dos seguintes códigos de estado HTTP:

Código de Estado Descrição
200 Sucesso. O Bing fez a fila de colocação da mensagem em fila para ser processada com êxito.
401 Não autorizado. O utilizador não está autorizado a utilizar a API ou a mensagem foi enviada a partir de um endereço IP desconhecido para o Bing ou que não está associado ao utilizador. Para determinar a causa, veja a mensagem de erro.
413 Entidade de pedido demasiado grande. O Feed de preços não pode exceder 100 MB ou 10 MB comprimidos.
429 Demasiados pedidos. Pode ter um máximo de cinco pedidos em fila ou a ser processados ao mesmo tempo. Se enviar um sexto pedido neste momento, o Bing devolve este erro.
500 Erro interno do servidor. Normalmente, trata-se de um erro transitório. Repita o pedido em intervalos de 1, 5 e 20 minutos. Se o pedido falhar após a terceira tentativa, contacte o TAM com as seguintes informações:

  • IDdoCliente
  • Data e hora em que os erros ocorreram.
  • O ID no cabeçalho de resposta WebRequestActivityId.

Corpo da resposta

Se ocorrer um erro HTTP, o corpo da resposta contém um documento XML que contém uma descrição do erro.

<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>

As tabelas seguintes descrevem os elementos encontrados na resposta ao erro.

Resposta a Erros

Define o elemento de nível superior de uma resposta de erro.

Elemento Descrição Crianças
ArrayOfApiError O elemento de nível superior de uma resposta de erro. Este elemento contém uma lista de erros que ocorreram. Matriz de ApiError

ApiError

Define um erro que ocorreu.

Elemento Descrição Crianças
Código Um código que identifica o erro que ocorreu. Por exemplo, IPAddressNotAllowed. Nenhum
Mensagem Uma mensagem que descreve o erro que ocorreu. Nenhum
Propriedade O nome da propriedade que causou o erro. Se o erro não estiver relacionado com uma propriedade, o atributo do nil elemento será definido como verdadeiro. Nenhum

Códigos e mensagens

O seguinte lista os códigos de erro e as mensagens que a API devolve.

Código Mensagem
AuthenticationFailure A autenticação falhou por motivos desconhecidos.
InternalError Erro interno do servidor.

Normalmente, trata-se de um erro transitório. Repita o pedido em intervalos de 1, 5 e 20 minutos. Se o pedido falhar após a terceira tentativa, contacte o TAM com as seguintes informações:

  • IDdoCliente
  • Data e hora em que os erros ocorreram.
  • O ID no cabeçalho de resposta WebRequestActivityId.
IPAddressNotAllowed O cliente {custId} não está autorizado a utilizar o endereço IP {clientIp}.

O cliente não está autorizado a enviar Feeds de preços a partir do endereço IP. Tem de enviar o pedido a partir de um endereço IP de servidor autorizado. Contacte o TAM para atualizar a lista de endereços IP do servidor autorizado.
NãoAuthorized O token OAuth para o qual definiu o cabeçalho autorização não é válido.
RequestThrottled O cliente {customerId} excedeu o número de pedidos permitidos.

Os clientes podem ter um máximo de cinco pedidos em fila ou a ser processados. O envio de um sexto pedido neste caso irá falhar.
RequestTooLarge O tamanho do pedido ({requestSizeBytes} bytes) excede o máximo permitido ({maxAllowed} bytes).

O Feed de preços não pode exceder 100 MB ou 10 MB comprimidos. Reduza o tamanho do seu Feed de preços para se ajustar aos limites.