API de sólo lectura de AstroBin

En resumen

AstroBin implementa un conjunto básico de API RESTful. Actualmente, las API son de solo lectura y permiten obtener datos sobre imágenes y realizar algunas búsquedas básicas.

Utilizando la API de AstroBin, podrá crear su propio sitio web, aplicación de escritorio o aplicación móvil que pueda utilizar algún contenido de AstroBin.

Algunas posibilidades:

  • Un widget web que muestra las imágenes recientes de un determinado usuario.

  • Un widget web que muestra la Imagen del día.

  • Un iPhone/Android para navegar eficazmente por AstroBin.

  • ... ¡y muchos más!

Disponibilidad y limitaciones

Actualmente, las API de AstroBin se limitan a recuperar información básica y realizar búsquedas sencillas en imágenes.

Los tipos de respuesta admitidos son XML y JSON.

Cómo empezar

Lo primero que necesitará es una clave API. Utilice el formulario de solicitud de clave API para obtenerla.

Cómo mostrar imágenes

La respuesta de la API le proporcionará varias propiedades url_*, cada una de las cuales representa un tamaño de imagen diferente.

Uso legítimo

No está permitido utilizar las API para extraer sin piedad todos los contenidos disponibles. El incumplimiento de este requisito conllevará la revocación permanente de la clave API.

Por favor, lea la sección API en las Condiciones del servicio.

Algunos ejemplos

Nota: todos los ejemplos omiten la URL base, los parámetros de autenticación y el parámetro de formato. Debes acordarte de incluirlos en el uso real, por ejemplo:

http://astrobin.com/api/v1/.../?...&api_key=...&api_secret=...&format=json

Recuerda que puedes combinar la mayoría de estas consultas, así que no dudes en experimentar.

Obtener una sola imagen por ID:

image/1234/

Búsqueda por temas:

image/?subjects=M31

# Nota: la búsqueda por temas está limitada a 100 resultados por razones de rendimiento.

Búsqueda por usuario:

image/?user=siovene

Búsqueda por título parcial, sin distinción entre mayúsculas y minúsculas:

image/?title__icontains=andrómeda

Búsqueda por mayúsculas y minúsculas, descripción parcial:

image/?description__icontains=viento

Otros trucos parciales útiles:

Comienza con
con=
contiene
__istartswith=
__iendswith=

Búsqueda por intervalo de fechas de carga:

image/?uploaded__gte=2012-04-10%200:00:00&uploaded__lt=2012-04-11%200:00:00

Operadores de comparación:

__lt=
__lte=
__gt=
__gte=

Consigue la imagen del día de hoy:

imageoftheday/?limit=1

Consigue la imagen del día de ayer:

imageoftheday/?limit=1&offset=1

Consigue las mejores selecciones:

toppick/

Consigue las nominaciones Top Pick:

toppicknomination/

Obtener un usuario por ID:

perfildeusuario/1234

Obtener un usuario por nombre de usuario:

userprofile/?username=siovene

Bibliotecas comunitarias

Aplicaciones y widgets comunitarios