Partager via

Codes d’erreur et messages

  • Article

Lorsque vous envoyez à Bing votre flux de prix (anciennement Message de transaction) à traiter, Bing peut retourner l’un des codes d’état HTTP suivants :

Code d’état Description
200 Opération réussie. Bing a correctement mis en file d’attente le message à traiter.
401 Non autorisé L’utilisateur n’est pas autorisé à utiliser l’API ou le message a été envoyé à partir d’une adresse IP inconnue de Bing ou qui n’est pas associée à l’utilisateur. Pour en déterminer la cause, consultez le message d’erreur.
413 Entité de demande trop grande. Le flux De prix ne doit pas dépasser 100 Mo ou 10 Mo compressés.
429 Trop de demandes. Vous pouvez avoir un maximum de cinq demandes en file d’attente ou en cours de traitement en même temps. Si vous envoyez une sixième requête à ce stade, Bing retourne cette erreur.
500 Erreur interne au serveur. Il s’agit généralement d’une erreur temporaire. Réessayez la demande à intervalles de 1, 5 et 20 minutes. Si la demande échoue après la troisième tentative, contactez votre tam avec les informations suivantes :

  • CustomerID
  • Date et heure auxquelles les erreurs se sont produites.
  • ID dans l’en-tête de réponse WebRequestActivityId.

Corps de la réponse

Si une erreur HTTP se produit, le corps de la réponse contient un document XML qui contient une description de l’erreur.

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

Les tableaux suivants décrivent les éléments trouvés dans la réponse d’erreur.

Réponse d’erreur

Définit l’élément de niveau supérieur d’une réponse d’erreur.

Élément Description Children
ArrayOfApiError Élément de niveau supérieur d’une réponse d’erreur. Cet élément contient une liste d’erreurs qui se sont produites. Tableau d’ApiError

ApiError

Définit une erreur qui s’est produite.

Élément Description Children
Code Code qui identifie l’erreur qui s’est produite. Par exemple, IPAddressNotAllowed. Aucun
Message Message qui décrit l’erreur qui s’est produite. Aucun
Propriété Nom de la propriété à l’origine de l’erreur. Si l’erreur n’est pas liée à une propriété, l’attribut de l’élément nil est défini sur true. Aucun

Codes et messages

L’exemple suivant répertorie les codes d’erreur et les messages retournés par l’API.

Code Message
AuthenticationFailure L’authentification a échoué pour des raisons inconnues.
InternalError Erreur interne au serveur.

Il s’agit généralement d’une erreur temporaire. Réessayez la demande à intervalles de 1, 5 et 20 minutes. Si la demande échoue après la troisième tentative, contactez votre tam avec les informations suivantes :

  • CustomerID
  • Date et heure auxquelles les erreurs se sont produites.
  • ID dans l’en-tête de réponse WebRequestActivityId.
IPAddressNotAllowed Le client {custId} n’est pas autorisé à utiliser l’adresse IP {clientIp}.

Le client n’est pas autorisé à envoyer des flux de prix à partir de l’adresse IP. Vous devez envoyer la requête à partir d’une adresse IP de serveur autorisée. Contactez votre TAM pour mettre à jour votre liste d’adresses IP de serveur autorisées.
Non autorisé Le jeton OAuth sur lequel vous définissez l’en-tête d’autorisation n’est pas valide.
RequestThrottled Le client {customerId} a dépassé le nombre de demandes autorisées.

Les clients peuvent avoir un maximum de cinq demandes en file d’attente ou en cours de traitement. Dans ce cas, l’envoi d’une sixième demande échoue.
RequestTooLarge La taille de la requête ({requestSizeBytes} octets) dépasse le maximum autorisé ({maxAllowed} octets).

Le flux De prix ne peut pas dépasser 100 Mo ou 10 Mo compressé. Réduisez la taille de votre flux De prix pour qu’il s’adapte aux limites.