daniel fienes weblog

Aktuelle Seite: Startseite / Archiv für api

api

fiene & twiturl im frühling

von Kommentar verfassen

1

Es gibt Neuigkeiten zu dem Short-URL-Dienst twiturl.de von Malte und mir. Es gibt zwei neue Funktionen, den Dienst noch etwas geschmeidiger machen:

  • Die Sache mit Twitter und dem .
    Es gibt einige Twitter-Clienten, die URLs nicht korrekt in Links umwandeln. Es gibt Nutzer, die regelmäßig nach einer Kurz-URL einen Punkt machen. Einige Twitter-Clienten (Böse, Twitterrific!) denken aber, der . gehört noch zu der URL. Es ist aber ein Unterschied, ob jetzt http://twiturl.de/wmm207 oder http://twiturl.de/wmm207. aufgerufen wird. Der Klicker landete auf einer Fehlerseite. Órgerlich. Absofort passiert das aber nicht mehr, da ich auf Seite von twiturl.de einen kleinen Workaround geschrieben habe, der den Bug der betroffenden Twitter-Clienten behebt. Absofort kann eine Twiturl mit oder ohne . aufgerufen werden – das Ziel ist immer das gleiche! (Dank an den Kollegen Horn für die Anregung!)
  • Neu in der API: Kodierte URLs können aufgerufen werden
    Ein Wunsch aus der Entwicklerecke: „Ist es möglich, dass ihr bei eurer API rawurlencoeded oder base64 encoded Strings annehmt, so dass es auch mit solchen Seiten keine Probleme gibt?“ Schöne Idee, ist absofort möglich! Das gibt dann keine Probleme mehr, wenn in den URLs ? und & vorkommen, und wenn zusätzlich ein Wunsch-Code übergeben wird. Wie das geht? Das steht im Blogeintrag zur API.

Weitere Blogeinträge zu twiturl.de:

fiene & twiturl api

von 4 Kommentare

1

Es gibt Neuigkeiten zu dem Short-URL-Dienst twiturl.de von Malte und mir. Ab sofort geben wir unsere API für den Testbetrieb frei. Ihr könnt die API also direkt für eure Programme und Plugins nutzen. Die wichtigsten Fakten sind jetzt hier in der FAQ zusammengefasst:

1. Wie erreiche ich die API?
http://api.twiturl.de/friends.php

2. Wie übergebe ich die Parameter an die API?
Die Variablen new_url (nötig) und new_code (optional) stehen derzeit zur Verfügung. Sie können per POST und GET Methode übergeben werden.

3. Was übergebe ich mit der Variable new_url?
Das ist die lange URL, die in eine Twiturl umgewandelt werden soll. Bitte komplett mit http:// übergeben.

4. Was übergebe ich mit der Variable new_code?
Hier kann ein Wunschcode übergeben werden. Ist dieser Code noch nicht in Benutzung, wird die lange URL künftig unter http://twiturl.de/wunschcode erreichbar sein.

5. Wie erhalte ich meine neue Twiturl?
Das Ergebnis des Aufrufs der API-URL (siehe Frage 1) wird im RSS 2.0 Format dargestellt. Im Linkfeld des ITEMS steht die neue Twiturl-Adresse und im Titelfeld wird der Code angezeigt. Hier ein Beispiel: twiturl_erfolg

6. Wie werden Fehler angezeigt?
Gibt es einen Fehler, wird auch dieser im RSS 2.0 Format dargestellt. Auch dieser kann vom Clienten ausgelesen werden. Fehlermeldungen können mit dem Titelfeld erkannt werden. Im Titel wird „Error“ angezeigt. Die Fehlerbeschreibung steht im Descriptionfeld. Hier ein Beispiel:
twiturl_error

7. Gibt es eine Beschränkung der Nutzung?
Derzeit ist die API frei zugänglich. Falls es die Nachfragelast zu stark wird, behalten wir uns Zugangsrestriktionen vor, um einen gerechten API-Zugang zu gewähren.

8. Wie kann ich die Statistik zu meiner Twiturl anzeigen lassen?
Zurzeit bieten wir die Statistiken noch nicht an. Die Statistiken können wie gewohnt unter http://stats.twiturl.de/wunschcode abgerufen werden.

9. Mein Client parst kein RSS. Kann ich den Output auch als Text anzeigen lassen?
Ja! Die Ausgabe kann von RSS 2.0 auf simplen Text umgestellt werden, wenn die Variable output mit dem Inhalt txt übergeben wird. Beispiel: http://api.twiturl.de/friends.php?new_url=http://www.netzeitung.de&output=txt gibt die generierte Twiturl (bzw. die Fehlermeldung) zurück.

10. Wie kann ich auch kodierte URLs übergeben (rawurlencode)?
Du kannst eine kodierte URL übergeben (nach RFC 1738), wenn du die Variable codetype mit dem Wert rawurlencoded übergibst. Beispiel: http://api.twiturl.de/friends.php?new_url=http://www.netzeitung.de&output=txt&codetype=rawurlencode macht es möglich eine kodierte URL zu übergeben, damit es zum Beispiel beim Zeichen & oder ? zu keinen Problemen kommt.

Neuigkeiten zur API werden künftig auch in diesem Blog-Eintrag dokumentiert.

Update:

  • Samstag, 10.01.09 um 19:05 Uhr: Output „Text“ hinzugefügt.
  • Sonntag, 04.04.10 um 21:55 Uhr: Rawurlencode hinzugefügt.

Links: