Passa ai contenuti principali

Integrare le funzionalità di Bing nei nostri siti web – Parte 4 – Gestione degli errori

Dopo aver dato un’occhiata alle basi delle API di Bing e di come possiamo utilizzarle (post1, post2 e post3) , in questo post ci occuperemo di come gestire  eventuali errori.

Supponiamo di eseguire la seguente richiesta Get:

http://api.search.live.net/xml.aspx?Appid=<appid>&query=&sources=images

dove <appid> è il nostro AppID descritto nei precedenti post.

Il risultato che otteniamo è il seguente:

captured_Image.png

Eventuali errori nella richiesta sono contenuti nella collezione di nodi <Errors> il cui singolo figlio ha il seguente formato:

captured_Image.png[6]

Tra i child del nodo <Error> troviamo:

<Code> : codice del messaggio d’errore (vedere tabella seguente);
<Message> : messaggio d’errore;
<Parameter> : eventuale parametro che ha generato l’errore;
<Value> : valore del parametro errato;
<HelpUrl> : URL della pagina MSDN di aiuto.

L’errore si verifica, generalmente, se l’URL della richiesta non è corretto oppure se la piattaforma Bing ha dei problemi oppure se l’appid utilizzato non è valido.
Non vengono restituiti errori, invece, se la ricerca non ha trovato risultati. In questo caso si hanno le collezioni dei risultati vuote.

Nella seguente tabella sono riportati i possibili errori (nell’attuale versione delle API)   che si possono verificare:

Codice

Descrizione

1001

 Nei parametri della query non è presente un parametro obbligatorio. In questo caso, il nodo <Parameter> fornisce indicazioni su quale parametro manca e non è presente il nodo <Value>.

1002

 Un parametro ha un valore errato. Il nodo <Parameter> fornisce indicazioni sul nome del parametro mentre il nodo <Value> riporta il valore errato.

1005

 La query è troppo lunga. La query non può superare i 2048 bytes.

2001

 L’appid che si sta utilizzando potrebbe essere disabilitato. Se l’appid è errato, si ottiene un errore con codice 1002.

2002

 L’appid ha superato il massimo numero di bytes scaricabili. Per maggiori informazioni si può consultare i termini di utilizzo del servizio.

2003

 L’appid che si sta utilizzando, pur essendo valido, non ha accesso alla sorgente di ricerca richiesta. Può succedere che alcune sorgenti di ricerca siano disponibili solo per particolari contratti con Microsoft.

3001

 Una o più delle sorgenti di ricerca richieste non sono attualmente disponibili.

3002

 Le API di Bing sono momentaneamente non disponibili.

4001

 Per comprendere il tipo di errore è necessario

     Riferimenti

Per maggiori informazioni potete consultare la documentazione presente ai seguenti link:

Bing API, Version 2
Bing Developer Center

 

Etichette:

Commenti

Posta un commento

Post popolari in questo blog

VB.NET: SplashScreen con effetto fade-in

In questo post vorrei proporvi un modo per realizzare una splash screen per le nostre applicazioni Windows Form che appare progressivamente con un effetto fade. Supponiamo di avere il nostro progetto VB.NET in una soluzione Visual Studio 2008 in cui abbiamo il sorgente della nostra applicazione Windows Form. Inseriamo una splash screen utilizzando il menù Progetto->Aggiungi Nuovo Elemento e selezionando il tipo di elemento “Schermata Iniziale” A questo punto Visual Studio creerà, automaticamente, la schermata iniziale che possiamo personalizzare graficamente come vogliamo. Per poter fare in modo che questa finestra appaia nel momento in cui avviamo l’applicazione, è necessario aprire le proprietà del progetto e impostare la maschera di avvio: In questo modo, all’avvio dell’applicazione, la schermata appare immediatamente e scompare un attimo prima della visualizzazione della finestra dell’applicazione. Possiamo far apparire la schermata iniziale con un ef
Posta un commento
Continua a leggere

VB.NET for Dummies: Gli Eventi

Vorrei iniziare con questo post una serie dedicata ad aspetti di VB.NET di base che possono essere utile a coloro che si avvicinano al mondo .NET e che, in genere, non vengono trattati a livello base. La serie di post non ha la pretesa di essere assolutamente esaustivi sugli argomenti che tratterò In questo primo post parleremo degli eventi. Cosa sono e a cosa servono Un evento è la “notifica” dell’accadimento di qualcosa. Quando, ad esempio, premiamo un bottone della finestra di un’applicazione, dietro le quinte, il bottone stesso “notifica” al mondo circostante che qualcuno, in quell’istante, lo ha premuto. Sta, poi, al mondo circostante preoccuparsi di “intercettare” l’evento stesso per gestirlo (tramite un gestore di evento). Attenzione a non confondere la pressione del tasto con la “notifica” della pressione del tasto: l’evento è la “notifica” dell’accadimento, non l’accadimento stesso. Ma a cosa serve tutto ciò? Utilizzare gli eventi è un modo per disaccoppiare
Posta un commento
Continua a leggere

Alla scoperta del Kinect: presentazioni e convenevoli

Oggi è arrivato un Kinect nuovo nuovo su cui cominciare a fare sperimentazione ed ho, quindi, deciso di condividere tutto ciò che scopro, le cavolate che faccio e i segreti che scopro con chi mi segue. I post che cercherò di scrivere con frequenza sono post di un neofita che si avvicina all’”Aggeggio” e che quindi sono diretti a chi nulla dell’argomento. Gli esperti troveranno noiosi e banali questi post, ma non si può aver tutto dalla vita. Per cominciare, scartato l’”Aggeggio” ho cominciato a preparare l’ambiente di sviluppo: 1) Visual Studio 2010 Ultimate (che uso normalmente ma che non è necessario in quanto si può sviluppare tranquillamente con la express edition); 2) Kinect SDK, scaricabile all’indirizzo http://research.microsoft.com/en-us/um/redmond/projects/kinectsdk/download.aspx 3) DirectX Software Development Kit scaricabile all’indirizzo http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812 A questo punto vi basta connettere il Kinect al
Posta un commento
Continua a leggere