API di sola lettura di AstroBin
In breve
AstroBin implementa una serie di API RESTfuldi base. Attualmente le API sono di sola lettura e consentono di ottenere dati sulle immagini e di eseguire alcune ricerche di base.
Utilizzando l'API di AstroBin, sarete in grado di creare un vostro sito web, un'applicazione desktop o un'applicazione mobile in grado di utilizzare alcuni contenuti di AstroBin.
Alcune possibilità:
Un widget web che visualizza le immagini recenti di un determinato utente.
Un widget web che visualizza l'immagine del giorno.
Un iPhone/Android per navigare efficacemente in AstroBin.
... e molti altri!
Disponibilità e limiti
Attualmente le API di AstroBin si limitano a recuperare informazioni di base e a eseguire semplici ricerche sulle immagini.
I tipi di risposta supportati sono XML e JSON.
Come iniziare
La prima cosa di cui avete bisogno è una chiave API. Per ottenerla, utilizzare il modulo di richiesta della chiave API.
Come visualizzare le immagini
La risposta dell'API fornirà diverse proprietà url_*, ognuna delle quali rappresenta una diversa dimensione dell'immagine.
Uso corretto
Non è consentito utilizzare le API per raschiare senza pietà tutti i contenuti disponibili. Il mancato rispetto di questo requisito comporterà la revoca permanente della propria chiave API.
Si prega di leggere la sezione API nei Termini di servizio.
Alcuni esempi
Attenzione: tutti gli esempi omettono l'URL di base, i parametri di autenticazione e il parametro di formato. È necessario ricordarsi di includerli nell'uso reale, ad esempio:
http://astrobin.com/api/v1/.../?...&api_key=...&api_secret=...&format=json
Ricordate che potete combinare la maggior parte di queste query, quindi sentitevi liberi di sperimentare!
Ottenere una singola immagine in base all'ID:
immagine/1234/
Ricerca per argomento:
image/?subjects=M31
# Nota: la ricerca per argomenti è limitata a 100 risultati per motivi di prestazioni.
Ricerca per utente:
image/?user=siovene
Ricerca per titolo parziale, senza distinzione tra maiuscole e minuscole:
image/?title__icontains=andromeda
Ricerca per descrizione parziale, senza distinzione tra maiuscole e minuscole:
image/?description__icontains=vento
Altri utili trucchi parziali:
__inizio con=
__fine con=
contiene=
__istartswith=
__iendswith=
Ricerca per intervallo di date di caricamento:
image/?uploaded__gte=2012-04-10%200:00:00&uploaded__lt=2012-04-11%200:00:00
Operatori di confronto:
__lt=
{\an8}Che cosa?
{\an8}Che cosa?
{\an8}Che cosa?
L'immagine del giorno di oggi:
imageoftheday/?limit=1
L'immagine del giorno di ieri:
imageoftheday/?limit=1&offset=1
Scoprite i Top Picks:
toppick/
Ottenere le nomination Top Pick:
toppicknomination/
Ottenere un utente in base all'ID:
profilo utente/1234
Ottenere un utente in base al nome utente:
profilo utente/?nomeutente=siovene
Biblioteche comunitarie
Android: AstroBinAPI di Gary Gause
PHP: Astrobin-WebServices di Stéphane Méaudre
Applicazioni e widget della comunità
Android
AstroBin for Muzei, a plugin for the Muzei app to get the Image of the Day as a wallpaper, by Jacek Beny.
AstroBasket, an unofficial Android app to browse the Image of the Day, Top Picks, Top Pick nominations, and with AstroBin search functionalities.
WordPress:
AstrobinIOTDWidget and AstrobinLastImageUser by Enol Matilla.