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:

https://www.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

Applicazioni e widget della comunità

  • Android

    • AstroBin for Muzei, un plugin per l'applicazione Muzei per ottenere l'immagine del giorno come sfondo, di Jacek Beny.

    • AstroBasket, un'applicazione Android non ufficiale per sfogliare le immagini del giorno, i Top Picks, le nomination Top Pick e le funzionalità di ricerca di AstroBin.

  • WordPress: