AstroBin's schreibgeschützte API

Kurz gesagt

AstroBin implementiert einen grundlegenden Satz von RESTful-APIs. Derzeit sind die APIs schreibgeschützt und ermöglichen es Ihnen, Daten über Bilder zu erhalten und einige grundlegende Suchen durchzuführen.

Mit Hilfe der AstroBin-API können Sie Ihre eigene Website, Desktop-Anwendung oder mobile App erstellen, die einige Inhalte von AstroBin verwenden kann.

Einige Möglichkeiten:

  • Ein Web-Widget, das die letzten Bilder eines bestimmten Benutzers anzeigt.

  • Ein Web-Widget, das das Bild des Tages anzeigt.

  • Ein iPhone/Android zum effektiven Durchsuchen von AstroBin.

  • ... und viele mehr!

Verfügbarkeit und Einschränkungen

Die APIs von AstroBin beschränken sich derzeit auf das Abrufen grundlegender Informationen und die Durchführung einfacher Suchen in Bildern.

Die unterstützten Antworttypen sind XML und JSON.

Wie man anfängt

Als erstes benötigen Sie einen API-Key. Bitte verwenden Sie das API-Key-Anforderungsformular, um einen zu erhalten.

Wie man Bilder anzeigt

Die API-Antwort liefert Ihnen mehrere url_*-Eigenschaften, von denen jede eine andere Bildgröße repräsentiert.

Faire Nutzung

Es ist nicht erlaubt, die APIs zu verwenden, um gnadenlos alle verfügbaren Inhalte zu scrapen. Die Nichteinhaltung dieser Anforderung führt zum dauerhaften Entzug des eigenen API-Schlüssels.

Bitte lesen Sie den Abschnitt API in den Nutzungsbedingungen.

Einige Beispiele

Bitte beachten Sie: Alle Beispiele lassen die Basis-URL, die Authentifizierungsparameter und den Format-Parameter weg. Sie müssen daran denken, sie in der realen Verwendung einzuschließen, z. B.:

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

Denken Sie daran, dass Sie die meisten dieser Abfragen kombinieren können, also experimentieren Sie ruhig!

Ein einzelnes Bild über seine ID holen:

image/1234/

Suche nach Thema:

image/?subjects=M31

# Hinweis: Die Suche nach Themen ist aus Leistungsgründen auf 100 Ergebnisse begrenzt.

Suche nach Benutzer:

image/?user=siovene

Suche nach Titel (Teilstring, ohne Berücksichtigung von Groß-/Kleinschreibung)

image/?title__icontains=andromeda

Suche nach Beschreibung (Teilstring, ohne Berücksichtigung der Groß- und Kleinschreibung):

image/?description__icontains=wind

Andere nützliche Parameterendungen:

__startswith=
__endswith=
__enthält=
__beginntmit=
__endswith= __endswith=

Suche nach Upload-Datumsbereich:

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

Vergleichsoperatoren:

__lt=
__lte=
__gt=
__gte=

Holen Sie sich das heutige "Bild des Tages":

imageoftheday/?limit=1

Holen Sie sich das gestrige "Bild des Tages":

imageoftheday/?limit=1&offset=1

Holen Sie sich die Top Picks:

toppick/

Holen Sie sich die Top Pick Nominierungen:

toppicknomination/

Abrufen eines Benutzers nach ID:

Benutzerprofil/1234

Ermittelt einen Benutzer anhand des Benutzernamens:

benutzerprofil/?benutzername=siovene

Bibliotheken der Gemeinschaft

Gemeinschaftliche Anwendungen und Widgets