Twoffein API FAQ

Hallo Developer, schön dich zu sehen!

Info Sowohl API als auch diese kleine Einleitung sind längst nicht fertig und weisen ggf. Fehler auf. Wir bitten dies zu berücksichtigen.


Einleitung

Die Sagenumwobene Twoffein API bietet dir eine ganz einfache Möglichkeit, Maschinenlesbar mit Twoffein zu arbeiten. Über sie kannst du in deiner App oder Internetseite eine zusammenfassung deines Twoffein-Profils bereitstellen, oder sogar einen automatisierten Tweet senden.

Alle Daten die du über unsere API bekommst, werden wahlweise im JSON oder XML Format ausgegeben, wodurch das Weiterverarbeiten ganz einfach vonstattengehen sollte.


Resource Beschreibung
GET drinks Listet alle Getränke auf.
GET profile Zeigt das Profil eines Twoffein-Nutzers.
POST tweet Sendet einen "Ich trinke gerade"-Tweet.
POST cookie Verschenkt einen Keks.
Fehlermeldungen Eine Übersicht der vermutlich in 123% der Fälle auftretenden Fehlermeldungen und -codes.

GET drinks

Listet alle Getränke auf.

https://twoffein.com/api/get/drinks/?screen_name=Harvey&api_key=A1B2C3D4E5&encode=xml

Parameter
screen_name
required
Der Twitter Nutzername
api_key
required
Twoffein-API-Key (Siehe Einstellungen)
encode
optional
Gibt die Werte entweder in json oder XML aus.

GET profile

Zeigt das Profil eines Twoffein-Nutzers.

https://twoffein.com/api/get/profile/?screen_name=Harvey&api_key=A1B2C3D4E5&profile=NichtHarvey

Parameter
screen_name
required
Der Twitter Nutzername
api_key
required
Twoffein-API-Key (Siehe Einstellungen)
encode
optional
Gibt die Werte entweder in json oder XML aus.
profile
optional
Wählt ein bestimmtes Profil nach screen_name, wenn leer wird auf das des Nutzers zurückgegriffen.

POST tweet

Sendet einen "Ich trinke gerade"-Tweet.

https://twoffein.com/api/post/tweet/?screen_name=Harvey&api_key=A1B2C3D4E5&drink=mate

Parameter
screen_name
required
Der Twitter Nutzername
api_key
required
Twoffein-API-Key (Siehe Einstellungen)
encode
optional
Gibt die Werte entweder in json oder XML aus.
target_screen_name
optional
Generiert einen "Ich trinke gerade ... mit ..."-Tweet.
drink
required
Wählt ein bestimmtes Profil nach key (Rückgabewert von GET drinks).

POST cookie

Verschenkt einen Keks.

https://twoffein.com/api/post/cookie/?screen_name=Harvey&api_key=A1B2C3D4E5&target_screen_name=Edna

Parameter
screen_name
required
Der Twitter Nutzername
api_key
required
Twoffein-API-Key (Siehe Einstellungen)
encode
optional
Gibt die Werte entweder in json oder XML aus.
target_screen_name
required
Empfänger des Kekses.

Fehler

Eine Übersicht der vermutlich in 123% der Fälle auftretenden Fehlermeldungen und -codes.

Code Bedeutung Zu finden in
fluttershy screen_name is required. Überall
applejack api_key is required. Überall
celestia User not found. Überall
rarity API-Key is wrong. Überall
sweetiebelle Whoop, whoop! You've already tweeted that! POST tweet
derpy An error occured. Please try again later. POST tweet
luna Your tweet has been tweeted. Thanks. POST tweet
pinkiepie You cant drink more than one drink in blah minutes. POST tweet
rainbowdash Please stop flooding our server(s), u noob! POST tweet
twilightsparkle Drink not found. POST tweet
applebloom drink is required. POST tweet
pwnd You're not allowed to perform this action. POST tweet
bigmacintosh Profile not found. GET profile
POST cookie
joe Drink with yourself. GET profile
POST cookie
gilda target_screen_name is required. POST cookie
scootaloo Sorry, one cookie/user/day. POST cookie