Codici e messaggi di errore

  • Articolo

Quando si invia Bing al feed Prezzi (in precedenza messaggio di transazione) per l'elaborazione, Bing può restituire uno dei codici di stato HTTP seguenti:

Codice di stato Descrizione
200 Completato. Bing ha accodato correttamente il messaggio da elaborare.
401 Non autorizzato. L'utente non è autorizzato a usare l'API o il messaggio è stato inviato da un indirizzo IP sconosciuto a Bing o non associato all'utente. Per determinare la causa, vedere il messaggio di errore.
413 Entità richiesta troppo grande. Il feed prezzi non deve superare 100 MB o 10 MB compressi.
429 Troppe richieste. È possibile che siano presenti al massimo cinque richieste in coda o in fase di elaborazione contemporaneamente. Se in questo momento si invia una sesta richiesta, Bing restituisce questo errore.
500 Errore interno del server. Si tratta in genere di un errore temporaneo. Ripetere la richiesta a intervalli di 1, 5 e 20 minuti. Se la richiesta ha esito negativo dopo il terzo tentativo, contattare tam con le informazioni seguenti:

  • CustomerID
  • Data e ora in cui si sono verificati gli errori.
  • ID nell'intestazione di risposta WebRequestActivityId.

Contenuto risposta

Se si verifica un errore HTTP, il corpo della risposta contiene un documento XML contenente una descrizione dell'errore.

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

Le tabelle seguenti descrivono gli elementi trovati nella risposta di errore.

Risposta di errore

Definisce l'elemento di primo livello di una risposta di errore.

Elemento Descrizione Children
ArrayOfApiError Elemento di primo livello di una risposta di errore. Questo elemento contiene un elenco di errori che si sono verificati. Matrice di ApiError

ApiError

Definisce un errore che si è verificato.

Elemento Descrizione Children
Codice Codice che identifica l'errore che si è verificato. Ad esempio, IPAddressNotAllowed. Nessuno
Messaggio Messaggio che descrive l'errore che si è verificato. Nessuno
Proprietà Nome della proprietà che ha causato l'errore. Se l'errore non è correlato a una proprietà, l'attributo dell'elemento nil è impostato su true. Nessuno

Codici e messaggi

Di seguito sono elencati i codici di errore e i messaggi restituiti dall'API.

Codice Messaggio
AuthenticationFailure L'autenticazione non è riuscita per motivi sconosciuti.
InternalError Errore interno del server.

Si tratta in genere di un errore temporaneo. Ripetere la richiesta a intervalli di 1, 5 e 20 minuti. Se la richiesta ha esito negativo dopo il terzo tentativo, contattare tam con le informazioni seguenti:

  • CustomerID
  • Data e ora in cui si sono verificati gli errori.
  • ID nell'intestazione di risposta WebRequestActivityId.
IPAddressNotAllowed Il cliente {custId} non è autorizzato a usare l'indirizzo IP {clientIp}.

Il cliente non è autorizzato a inviare feed di prezzo dall'indirizzo IP. È necessario inviare la richiesta da un indirizzo IP del server autorizzato. Contattare il TAM per aggiornare l'elenco di indirizzi IP del server autorizzati.
NotAuthorized Il token OAuth su cui è stata impostata l'intestazione Authorization non è valido.
RequestThrottled Il cliente {customerId} ha superato il numero di richieste consentite.

I clienti possono avere un massimo di cinque richieste in coda o in fase di elaborazione. L'invio di una sesta richiesta in questo caso avrà esito negativo.
RequestTooLarge Le dimensioni della richiesta ({requestSizeBytes} byte) superano il numero massimo consentito ({maxAllowed} byte).

Il feed prezzi non può superare 100 MB o 10 MB compressi. Ridurre le dimensioni del feed di prezzi in base ai limiti.