Zend_Service_Twitter Einführung Zend_Service_Twitter bietet einen Client für die REST API von Twitter. Zend_Service_Twitter erlaubt es eine öffentliche Zeitachse abzufragen und wenn man einen Benutzernamen und ein Passwort für Twitter angibt, ist es auch erlaubt den eigenen Status zu erhalten und zu aktualisieren, Freunden zu antworten, Nachrichten an Freunde schicken, Tweets als Favoriten markieren und vieles mehr. Zend_Service_Twitter implementiert einen REST Service und alle Methoden geben eine Instanz von Zend_Rest_Client_Result zurück. Zend_Service_Twitter ist in Untersektionen geteilt damit man einfachst erkennen kann welcher Typ von Aufrufen angefragt wird. account, stellt sicher das die eigenen Zugangsdaten gültig sind, prüft das API Limit und beendet die aktuelle Session für den authentifizierten Benutzer. status, empfängt die öffentlichen und die Zeitlinien von Benutzern, und erlaubt es Sie anzusehen, zu aktualsieren, zu zerstören und Antworten für den authentifizierten Benutzer zu empfangen. user, empfangen von Freunden, Verfolger des authentifizierten Benutzers. Mit der show Methode kann man erweiterte Informationen über den angegebenen Benutzer erhalten. directMessage, empfängt die direkten Nachrichten des authentifizierten Benutzers und erlaubt es neue direkte Nachrichten zu senden und zu löschen. friendship, erstellt oder entfernt eine Freundschaft für den authentifizierten Benutzer. favorite, auflisten, erstellen oder entfernen eines favorisierten Tweets. Authentifizierung Mit der Ausnahme des Holens der öffentlichen Zeitlinie benötigt Zend_Service_Twitter eine Authentifizierung um zu funktionieren. Twitter verwendet aktuell eine HTTP Basis Authentifizierung. Man kann den eigenen Benutzernamen oder eine registrierte Email mit dem Passwort, für das Login bei Twitter, übergeben. Erstellung der Twitter Klasse Das folgende Codebeispiel zeigt wie man den Twitter Service erstellt, den Benutzernamen und das Passwort übergibt, und dann überprüft ob Sie korrekt sind. account->verifyCredentials(); ]]> Account Methoden verifyCredentials, verwende diese Methode um zu Testen ob die angegebenen Benutzerdaten gültig sind, und das mit einem minimalen Overhead. Die Angaben prüfen account->verifyCredentials(); ]]> endSession, verwende diese Methode um Benutzer aus der Clientanwendung abzumelden. Beenden von Sessions account->endSession(); ]]> rateLimitStatus, gibt die restliche anzahl von API Anfragen zurück die der authentifizierte Benutzer noch hat, bevor das API Limit für die aktuelle Stunde erreicht ist. Status des Rating Limits account->rateLimitStatus(); ]]> Status Methoden publicTimeline, gibt die 20 letzten Statusmeldungen von nicht geschützten Benutzern mit einem eigenen Benutzericon zurück. Die öffentliche Zeitlinie wird von Twitter alle 60 Sekunden gecacht. Empfangen der öffentlichen Zeitlinie status->publicTimeline(); ]]> friendsTimeline, gibt die 20 letzten Statusmeldungen zurück die von authentifizierten Benutzer gesendet wurden und den Freunden dieser Benutzer. Empfangen der Zeitlinie von Freunden status->friendsTimeline(); ]]> Die friendsTimeline Methode akzeptiert ein Array von optionalen Parameters um die Abfrage zu verändern. since, grenzt die zurückgegeben Ergebnisse auf jene Statusmeldungen ein die nach dem spezifizierten Datum/Zeit (bis zu 24 Stunden alt) erstellt wurden. page, die Seite die man zurückbekommen will. userTimeline, gibt die 20 letzten Statusmeldungen zurück die von authentifizierten Benutzern geschrieben wurden. Empfangen der Zeitlinie von Benutzern status->userTimeline(); ]]> Die userTimeline Methode akzeptiert ein Array von optionalen Parametern um die Abfrage zu verändern. id, spezifiziert die ID oder den Bildschirmnamen des Benutzers für den die friends_timeline zurückzugeben ist. since, grenzt die zurückzugebenden Ergebnisse auf jene Stati ein die nach dem spezifizierten Datum/Zeit (bis zu 24 Stunden als) erstellt wurden. page, welche Seite zurückgegeben werden soll. count, spezifiziert die Anzahl der Stati die man erhalten will. Kann nicht größer als 200 sein. show, gibt einen einzelnen Status zurück, der durch den ID Parameter, wie anbei, spezifiziert wird. Der Author des Status wird auch zurückgegeben. Diese Methode benötigt eine Tweet ID die an Sie übergeben wird. Den Status eines Benutzers sehen status->show(1234); ]]> update, aktualisiert den Status des authentifizierten Benutzers. Diese Methode erwartet das der aktualisierte Status übergeben wird den man an Twitter übermitteln will. Ein zweiter optionaler Parameter ist die ID des Tweets auf den man antwortet. Aktualisieren des Benutzerstatus status->update('Mein größter Tweet'); ]]> Die update Methode akzeptiert einen zweiten optionalen Parameter. in_reply_to_status_id, die ID eines bestehenden Status auf den dieser Status als Antwort gesendet werden soll. replies, gibt die 20 letzten Antworten/@replies (Statusaktualisierungen die mit @username anfangen) für den authentifizierten Benutzer zurück. Zeigt Benutzerantworten status->replies(); ]]> Die replies Methode akzeptiert ein Array von optionalen Parametern um die Anfrage zu verändern. since, grenzt die Ergebnisse die man erhält auf jene ein, deren Stati nach dem spezifizierten Datum/Zeit (bis zu 24 Stunden alt) erstellt wurden. page, welche Seite soll zurückgegeben werden. since_id, gibt nur Stati zurück die eine größere ID (das ist die aktuellere) als die spezifizierte ID haben. destroy, entfernt den Status der durch den benötigten ID Parameter spezifiziert ist. Löschen eines Benutzerstatus status->destroy(12345); ]]> Benutzermethoden friends, gibt bis zu 100 Freunde des authentifizierten Benutzers zurück, die zuletzt aktualisiert haben, und jeden von Ihnen mit dem aktuellen Status. Empfangen von Benutzerfreunden user->friends(); ]]> Die friends Methode akzeptiert ein Array von optionalen Parameter um die Abfrage zu verändern. id, spezifiziert die ID oder den Bildschirmnamen des Benutzers von dem die Liste an Freunden zurückgegeben werden soll. since, grenzt die zurückzugebenden Ergebnisse auf jene Stati ein die nach dem spezifizierten Datum/Zeit (bis zu 24 Stunden als) erstellt wurden. page, welche Seite soll zurückgegeben werden. followers, gibt die Verfolger des authentifizierten Benutzers zurück, und jeden von Ihnen mit seinem aktuellen Status. Empfangen der Verfolger eines Benutzers user->followers(); ]]> Die followers Methode akzeptiert ein Array von optionalen Parametern die die Anfrage verändern. id, spezifiziert die ID oder den Bildschirmnamen des Benutzers von dem die Liste an Verfolgern zurückgegeben werden soll. page, welche Seite soll zurückgegeben werden. show, gibt erweiterte Informationen über einen angegebenen Benutzer zurück, der durch eine ID oder einen Bildschirmnamen spezifiziert wird wie durch den anbei benötigten ID Parameter. Zeigt Benutzerinformationen user->show('myfriend'); ]]> Methoden zur direkten Benachrichtigung messages, gibt eine Liste der 20 letzten direkten Nachrichten für den authentifizierten Benutzer zurück. Empfangen der letzten empfangenen direkten Nachrichten directMessage->messages(); ]]> Die message Methode akzeptiert ein Array von optionalen Parametern um die Anfrage zu verändern. since_id, gibt nur direkte Nachrichten mit einer ID zurück, die größer als (das ist aktueller als) die spezifizierte ID sind. since, grenzt die zurückzugebenden Ergebnisse auf jene Stati ein die nach dem spezifizierten Datum/Zeit (bis zu 24 Stunden als) erstellt wurden. page, welche Seite soll zurückgegeben werden. sent, gibt eine Liste der 20 letzten direkten Nachrichten zurück die vom authentifizierten Benutzer gesendet wurden. Empfangen der letzten gesendeten direkten Nachrichten directMessage->sent(); ]]> Die sent Methode akzeptiert ein Array von optionalen Parametern um die Abfrage zu verändern. since_id, gibt nur direkte Nachrichten mit einer ID zurück, die größer als (das ist aktueller als) die spezifizierte ID sind. since, grenzt die zurückzugebenden Ergebnisse auf jene Stati ein die nach dem spezifizierten Datum/Zeit (bis zu 24 Stunden als) erstellt wurden. page, welche Seite soll zurückgegeben werden. new, sendet eine neue direkte Nachricht vom authentifizierten Benutzer zum spezifizierten Benutzer. Benötigt sowohl den Benutzer also auch den Text Parameter wie unten gezeigt. Senden einer direkten Nachricht directMessage->new('myfriend', 'mymessage'); ]]> destroy, entfernt eine direkte Nachricht die im benötigten ID Parameter spezifiziert wird. Der authentifizierte Benutzer muß der Empfänger der spezifizierten direkten Nachricht sein. Löschen einer direkten Nachricht directMessage->destroy(123548); ]]> Methoden für die Freundschaft create, befreundet den im ID Parameter spezifizierten Benutzer mit dem authentifizierten Benutzer. Erstellung eines Freundes friendship->create('mynewfriend'); ]]> destroy, beendet die Freundschaft des im ID Parameter spezifizierten Benutzers, mit dem authentifizierten Benutzer. Löschen eines Freundes friendship->destroy('myoldfriend'); ]]> exists, tested ob eine Freundschaft zwischen dem authentifizierten Benutzer und dem übergebenen Benutzer existiert. Prüfen ob eine Freundschaft existiert friendship->exists('myfriend'); ]]> Methoden für Favoriten favorites, gibt die 20 letzten Stati von Favoriten für den authentifizierten oder durch den ID Parameter spezifizierten Benutzer zurück. Favoriten empfangen favorite->favorites(); ]]> id, die ID oder der Bildschirmname des Benutzers von dem die Liste der bevorzugten Stati zurückgegeben werden soll. page, welche Seite soll zurückgegeben werden. create, favorisiert den mit dem ID Parameter spezifizierten Status für den authentifizierten Benutzer Favoriten erstellen favorite->create(12351); ]]> destroy, entfernt die Favorisierung des des mit dem ID Parameter spezifizierten Status für den authentifizierten Benutzer. Entfernt Favoriten favorite->destroy(12351); ]]>