Twitter API: Grundlagen

Warum ist Twitter überall im Web?

Die Programmierschnittstelle von Twitter  macht’s möglich

Immer häufiger sieht man, dass Website-Betreiber ihre letzten Tweets auf ihrer Website anzeigen oder Retweet-Buttons einbinden, die anzeigen, wie oft ein Blogbeitrag bereits getwittert wurde. Wie geht das? Guckt man als Website-Betreiber nach, was seine letzten Tweets waren oder wie oft der letzte Blogbeitrag getwittert wurde und codiert das dann in HTML? Natürlich nicht. Solche Dinge lassen sich automatisieren. Die Twitter API macht’s möglich. API steht dabei für Application Programming Interface und meint die Programmierschnittstelle von Twitter. Twitter ermöglicht Entwicklern nämlich sehr viele Zugriffsmöglichkeit auf Twitter-Daten. Das sorgt dafür, dass Twitter überall im Web mit verschiedensten Plugins und Mashups präsent ist.

Die Twitter API als einfache Programmierschnittstelle

Dabei ist die Twitter API eine sehr einfache Programmierschnittstelle, die im Vergleich zur Facebook API nur sehr geringe Einarbeitungszeiten für Entwickler bedeutet und extrem viele Freiheiten erlaubt. So ist es theoretisch möglich Applikationen mit fast allen gängigen Programmiersprachen zu entwickeln, die die Möglichkeit haben HTTP-Requests abzusenden. Die Twitter API basiert nämlich auf dem HTTP-Standard.

Neben vielen Freiheiten setzt Twitter den Entwicklern aber auch Grenzen. So kann man beispielsweise nicht mehr als 250 Direct Messages pro Tag über die API versenden. Auch mehr als 150 API-Requests in einer Stunden sind nicht drin.

„Hello World!“ mit der API

Sehen wir uns nun einmal die API am Beispiel eines „Hello World!“-Programms etwas genauer an. „Hello World!“ oder auch „Hallo Welt!“ Programme sind einfache Programme oder Scripte, die demonstrieren sollen, welche Anweisungen ein Programm in einer bestimmten Programmiersprache mindestens enthalten muss, damit es funktioniert.

Hier wollen wir unseren Twitter-Status per Programmierschnittstelle updaten und zwar mit dem Text „Hello API World!“. Im Beispiel wollen wir PHP als Programmiersprache nutzen. Unser Scriptcode würde so aussehen:

In den Zeilen 4 und 5 definiert man zuerst seine Twitter-Kennung, damit man auf die API zugreifen kann. In Zeile 9 wird unsere Nachricht festgelegt, die dann als Tweet veröffentlicht werden soll. In den Zeilen 11, 12 und 13 wird die Twitter API Methode definiert, die verwendet werden soll. Wir möchten ja unseren Status updaten und somit kommt nur die Methode „Statuses Update“ infrage. Die Twitter API Methoden sind auch online dokumentiert: http://apiwiki.twitter.com/Twitter-API-Documentation

Fehlt nur noch eines, nämlich dass der Status tatsächlich veröffentlicht wird. Dies passiert in Zeile 25. Aber bis dahin ist noch etwas Vorarbeit nötig. Ab Zeile 15 muss man sich zuerst mit cURL herumschlagen. PHP bietet mehrere cURL-Funktionen an, die dabei helfen einen HTTP-Request abzusetzen (den man für die Arbeit mit der Twitter API braucht).

Zu guter Letzt lassen wir uns noch anzeigen, ob soweit auch alles geklappt hat. Dazu geben wir das Rückgabeobjekt aus, das uns Twitter nach dem API Request sendet (Zeile 31). Im Idealfall sieht die Ausgabe dieses einfachen Programms so aus:

Das ist das zurückgegebene JSON-Objekt, mit all seinen Eigenschaften. Oben ist als API definiert, was zeigt, dass es sich um einen API-Request handelte. Unten ist mit noch einmal der Tweet-Text aufgelistet.

So würde man auch merken, wenn etwas schief gelaufen ist. Es könnten theoretisch viele Dinge schief laufen: Twitter-Kennung ist falsch, der Methodenaufruf ist falsch oder man will einen Tweet senden, der bereits im Twitter-Account gesendet wurde. Das mag Twitter gar nicht und weist notfalls den Entwickler darauf hin:

Aber in unserem Fall ging alles glatt und der Tweet ist somit online:

Vielseiteige Einsatzmöglichkeiten

Die Twitter API ist vielseitig Einsetzbar. Der Kreativität der Entwickler sind nur sehr wenige Grenzen gesetzt. Man kann durch die API z. B.

• anderen Twitter-Usern folgen (wenn man es geschickt macht, sogar automatisiert und auf Keywordbasis)
• Mashups entwickeln, die z. B. weitere APIs verwenden (z. B. Von URL Shortening-Diensten)
• automatisiert Tweets von allen möglichen Twitter-Usern anzeigen lassen und diese Tweets nach bestimmten Kriterien auswählen
• etc.

Die Möglichkeit Tweets von anderen Twitter-Usern anzeigen zu lassen ist nicht zuletzt auch für Google interessant, die ja bekanntlich damit begonnen haben, Tweets in den Suchergebnissen einzubinden.

Fortgeschrittene Möglichkeiten der API

Für den fortgeschrittenen Einsatz der Twitter-API bietet Twitter viele weitere Möglichkeiten. Z. B. Ist für Entwickler das unterstützte OAuth-Protokoll interessant. Es sorgt für ein sicheres Login von Twitter-Nutzern bei via API erstellten Applikationen. Interessant ist es deshalb, weil der Twitter-Nutzer seine Zugangsdaten der Applikation nicht mitteilt, sondern über die Twitter API eine Authentifizierung vornimmt. Den OAuth-Dialog haben die meisten Twitter-Nutzer wohl schon einmal gesehen:

(Quelle: flickr)

Bewertung der Twitter API

Die Twitter API bietet den Entwicklern viel. Twitter ist im Vergleich zu Facebook relativ einfach was die Funktionen der Plattform angeht. Dies macht sich auch in der API bemerkbar. Die Facebook-API ist z. B. im Vergleich zu der von Twitter ein Ungetüm. Die Twitter API ist übersichtlich, gut dokumentiert und man findet einen schnellen Einstieg.

Über den Autor

Axel Scheuering (@axelscheuering) absolvierte an der FH Würzburg ein Studium der Wirtschaftsinformatik und arbeitet jetzt im Bereich Online-Marketing. In seiner Freizeit beschäftigt er sich mit Webentwicklung und Internet-Themen.

Ähnliche Artikel:

1. Twitter überschreitet Grenze