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

 

Commenti

Post popolari in questo blog

VB.NET: Convertire un file DOC in RTF e PDF con office interop

In questo post vorrei proporvi del codice per poter convertire un file .doc in un file .rtf oppure .pdf utilizzando le API di interoperabilità di Office.Creeremo una classe, DocConverter, che esporrà le due funzionalità sopra citate.Cominciamo con il prevedere un attributo privato della classe che rappresenterà l’applicazione Word che utilizzeremo per la conversione. Creeremo l’istanza dell’attributo privato all’interno del costruttore della classe:PublicSubNew()
IfNot CreateWordApp() Then
ThrowNew ApplicationException("Assembly di interoperabilità con Office non trovato!")
EndIf
EndSub
Private _wordApp As Word.ApplicationClass
ProtectedFunction CreateWordApp() AsBoolean
Dim retval = True
Try
_wordApp = New Word.ApplicationClass()
_wordApp.Visible = False
Catch ex As System.Exception
_wordApp = Nothing
retval = False
EndTry
Return retval
EndFunction

La conversione del file doc sarà effettuata aprendo il file stesso ed eseguendo un’operazione di SaveAs:

Pr…

Cambiare la lingua di Visual Studio 2008

Oggi ho avuto qualche problema installando Windows Mobile 6 Professional SDK Refresh e Windows Mobile 6 Standard SDK Refresh.Scaricati i file di installazione e installati, ho provato a creare un progetto di tipo Windows Mobile 6.0 e mi sono beccato questo errore:Dopo qualche smanettamento abbiamo scoperto (e ringrazio il mitico Matteo per l’aiuto) che il mio Visual Studio 2008, pur essendo in Inglese (prova ne era il fatto che gli hotfix e la SP installata erano nella lingua di Albione) aveva come lingua impostata quella del sistema operativo (italiano).Ovviamente, non avrebbe mai potuto trovare la cartella 1040 (italiano) visto che l’installazione dell’SDK aveva supposto che la lingua del Visual Studio fosse Inglese (1033).La soluzione del problema è duplice:1) Duplicate la cartella 1033 presente nel percorso evidenziato dall’errore e la rinominate 10402) cambiate la lingua di Visual Studio.Per questa ultima eventualità basta andare nel menù Strumenti/Opzioni:e cambiare il linguaggi…

Tascam DR-05 registratore digitale per tutti

Diverso tempo fa ho acquistato il registratore digitale Tascam DR-05 e, ora, dopo diversi mesi di utilizzo, posso dire la mia a proposito.

Si tratta di un ottimo registratore digitale con microfono stereo che permette di ottenere registrazioni di ottima qualitaà anche in ambienti non perfetti dal punto di vista acustico.

Interessante la possibilità di utilizzare un cavalletto di piccole dimensioni come HAMA Mini treppiede o Mini Cavalletto Universale per tenere il microfono sollevato dal tavolo in fase di registrazione grazie allàattacco universale per macchina fotografica che il microfono ha nella parte inferiore.

Da segnalare anche il menu’ ben fatto e la possibilita’ di utilizzare una scheda SD esterna per memorizzare i file audio. Anche a livello di consumo batterie non e’ niente male. Consiglio l’uso delle alcaline non ricaricabili.

Il mio utilizzo e’ stato prettamente di registrazione di podcast vocali (no musica) ma le recensioni confermano che se la cava egregiamente con la mu…