redir.ec - kurze Links und mehr

Features:

einfache und schnelle Anmeldung
redir.ec Bookmarklet, Einfach per Drag'n'Drop auf deine Lesezeichen ziehen, um von überall ganz einfach URLs zu kürzen
Ausführliche Statisiken für jede Kurz-URL (Beispiel)
Direkt von redir.ec aus twittern
Optionale Wunsch-URL
Firefox Addon URLs via Kontextmenü kürzen und automatisch in der Zwischenablage speichern
Wordpress Plugin - Permalinks via redir.ec kürzen und direkt tweeten

Einführung in die redir.ec API

Erstellen einer redir.ec Kurzurl (create)

redir.ec Kurzurls werden über die URL (http://redir.ec/_api/rest/redirec/create) erstellt.

Es gibt 4 Parameter (url, redirec, appid, apikey) dabei ist der URL Parameter (url) zwinged erforderlich.

Beispielaufruf mit allen Parametern:


        http://redir.ec/_api/rest/redirec/create?url=http%3A%2F%2Fwww.domain.de%2F%3Fhaesslicher%3Dparameter&redirec=meine-wunsch-url&appid=meine-anwendung&apikey=1a1a1a1a1a1a1a1a

Dieser Aufruf würde bei Erfolg folgende URL im Inhalt der Antwort ausgeben:


        http://redir.ec/meine-wunsch-url

Beispielaufruf mit minimalen Parametern:


        http://redir.ec/_api/rest/redirec/create?url=http%3A%2F%2Fwww.domain.de%2F%3Fhaesslicher%3Dparameter

Dieser Aufruf würde bei Erfolg beispielsweise folgende URL im Inhalt der Antwort ausgeben:


        http://redir.ec/thDM

Die Parameter

url: Die zu kürzende URL. Der Parameter muss vorhanden und URL encodiert sein.
Beispiele für den Wert des Parameters: http%3A%2F%2Fwww.domain.de%2F%3Fhaesslicher%3Dparameter http%3A%2F%2Fwww.foobar.de%2F
redirec: Eine optionale redir.ec Wunsch-Id. Falls der Parameter nicht vorhanden ist, wird ein zufällige Id erstellt.
Beispiele für den Wert des Parameters: meine-wunsch-url neue-spam-infos
appid: Eine optinale Applikations-Id. Diese Id wird gespeichert um später Ausgeben zu können über welchen Service die redir.ec API verwendet wurde. Die Übergabe von Text und URL ist auch möglich, dann sollte der Parameter URL-kodiert sein.
Beispiele für den Wert des Parameters: meine-api twitter tweetdeck My+tool+from+http%3A%2F%2Fwww.my-tool-box.de%2F
apikey: Dein API Key. Wenn du deinen API Key angibst, wird die über die API gekürzte URL deinem Account zugeschrieben. Deinen API Key findest du im Login Bereich unter Profil.
Beispiel für den Wert des Parameters: 1a1a1a1a1a1a1a1a

Die Antworten

Code 200: Wenn der URL erfolgreich erstellt wurde liefert der Server die HTTP Status Code 200 mit der gekürztem URL im Inhalt der Seite.
Beispielantwort: http://redir.ec/meine-wunsch-url http://redir.ec/thDM
Code 404: Bei einem Fehler liefert der Server den Code 404 mit einer Fehlerbeschreibung im Inhalt der Seite.
Antwort im Fehlerfall: Pflichtfeld URL nicht angegeben oder leer. please provide a url to shorten
Antwort im Fehlerfall: Pflichtfeld URL zu kurz, es müssen mindestens 8 Zeichen sein. please provide a longer url
Antwort im Fehlerfall: Die angegebene Wunsch-Id (redirec) enthält nicht erlaubte Zeichen. Erlaubt sind A-Z, a-z, 0-9 und Bindestrich (-). your provided custom url name contains forbidden characters
Antwort im Fehlerfall: Die angegebene Wunsch-Id (redirec) ist bereits verwendet. your provided custom url name is already in use
Antworten im Fehlerfall: Die angebene URL ist bereits eine redir.ec URL. the url you provided is short enough

Abrufen des Ziels einer gekürzten URL (expand)

Umkehrfunktion zu Erstellung (create) einer Kurzurl.

Beispielaufruf:


        http://redir.ec/_api/rest/redirec/expand?redirec=http%3A%2F%2Fredir.ec%2Ftx0b

Dieser Aufruf würde bei Erfolg folgende URL im Inhalt der Antwort ausgeben:


        http://translate.google.com/translate_t#en|de|Short%20this%20really%20long%20URL%20with%20redir.ec!

Der Parameter

redirec: Die gekürzte URL oder nur der redirec. Der Parameter muss vorhanden und URL encodiert sein.
Beispiele für den Wert des Parameters: http%3A%2F%2Fredir.ec%2Ftx0b tx0b

Die Antworten

Code 200: Wenn die redirec URL existiert liefert der Server die HTTP Status Code 200 mit der langen URL im Inhalt der Seite.
Beispielantwort: http://translate.google.com/translate_t#en|de|Short%20this%20really%20long%20URL%20with%20redir.ec!
Code 404: Bei einem Fehler liefert der Server den Code 404 mit einer Fehlerbeschreibung im Inhalt der Seite.
Antwort im Fehlerfall: redirec not valid or unknown