Struttura di un feed JSON di Twitter

Un feed JSON di Twitter è semplicemente un file contenente un oggetto JSONP (JSON with Padding) che a sua volta contiene delle informazioni sull'utente selezionato e sui suoi tweet. Il file è dinamico, nel senso che i suoi dati cambiano in base al tipo di parametri passati nell'URL della richiesta. In questo articolo ci soffermeremo sulla struttura di questo file JSON.

URL di base e parametri

L'URL di base è il seguente:

http://api.twitter.com/1/statuses/user_timeline.json?

I parametri sono:

1. screen_name: il vostro nome utente su Twitter
2. count: il numero di tweet da restituire
3. callback=?: specifica che il feed è di tipo JSONP

Esempio:

http://api.twitter.com/1/statuses/user_timeline.json?screen_name=gabromanato&count=2&callback=?

Dati utente

All'interno dell'oggetto JSON, l'oggetto user contiene i dati dell'utente selezionato. I più interessanti sono:

1. profile_link_color: il valore esadecimale del colore dei link nel profilo
2. profile_sidebar_border_color: il valore esadecimale del colore del bordo della barra laterale
3. followers_count: il numero di followers dell'utente
4. location: la posizione geografica dell'utente
5. url: l'URL del sito dell'utente
6. description: la descrizione personale del profilo dell'utente
7. listed_count: il numero di liste di Twitter in cui compare l'utente
8. profile_background_color: il colore di sfondo della pagina del profilo dell'utente
9. profile_background_image_url: l'URL dell'immagine di sfondo della pagina del profilo dell'utente
10. created_at: la data d'iscrizione dell'utente a Twitter
11. profile_text_color: il colore del testo della pagina del profilo dell'utente
12. profile_sidebar_fill_color: il colore di sfondo della barra laterale del profilo dell'utente
13. profile_image_url: l'URL dell'immagine del profilo dell'utente
14. statuses_count: il numero di tweet pubblicati

Tweet

I dati rilevanti sui tweet sono contenuti in:

1. text: il contenuto del tweet
2. created_at: la data e l'ora di creazione del tweet
3. source: il sito di origine
4. in_reply_to_user_id, in_reply_to_screen_name: l'eventuale ID e nome utente del destinatario del tweet di risposta
5. id_str, id: l'ID univoco del tweet

Reperire i dati

Il feed JSON è fatto di oggetti, quindi occorre accedere in un ciclo a ciascun oggetto per poter usare le proprietà menzionate. Per esempio, in jQuery possiamo usare il seguente codice:

var url = 'http://api.twitter.com/1/statuses/user_timeline.json?screen_name=gabromanato&count=2&callback=?';

$.getJSON(url, function(data) {


	$.each(data, function(i, item) {
	
		var user = item.user;
		var tweet = item.text;
		var tweetTime = item.created_at;
	
		//...
	
	});



});

In questo caso abbiamo utilizzato un ciclo $.each() per accedere ai dati dell'oggetto JSON. Un equivalente in JavaScript è il ciclo for...in.