Kurze URL API

krz.ch bietet eine API Schnittstelle (mit GET und POST) mit der Sie unseren Service in Ihre Webseite integrieren können:

GET Methode

Die einfachste Art und Weise ist die GET: Alles was Du machen must ist eine URL-Anfrage ähnlich wie die nachfolgende zu erstellen:

http://krz.ch/?module=ShortURL&file=Add&url=http%3A%2F%2Fvergleiche.ch%2Fmp3player%2Fueber_50gb_speicher%2Fapple_ipod_classic_120gb_silber_mb562

oder http://krz.ch/?module=ShortURL&file=Add&mode=API&url=http://www.vergleiche.ch/mp3player/ueber_50gb_speicher/apple_ipod_classic_120gb_silber_mb562

Als Antwort erhälst Du einen plain text String mit der gekürzten URL, wie z.B.:
http://krz.ch/3f84cb

Folgende GET Variablen sind erlaubt:
go - entweder "twitter" oder "pownce" - Führt den Nutzer zu Twitter.com oder Pownce.com. Das Formular ist mit der gekürzten URL bereits ausgefüllt.

iPhone Twitter Client: Tweetie 2.0

Nutzt Du Tweetie 2.0 auf deinem iPhone? Wenn ja, kannst Du dort die Einstellungen für "Custom URL-Shortener" so einstellen, dass deine Links direkt mit krz.ch gekürzt werden.

Dazu musst Du unter: -> settings -> url shortening ->custom folgendes eingeben:
http://krz.ch/?module=ShortURL&file=Add&mode=API&url=%@

Wenn Du möchtest, dass Deine gekürzten URLs direkt Deinem Account zugeordnet werden und somit in Deinen persönlichen Statisiken erscheinen, dann verwende folgenden String:
http://krz.ch/?module=ShortURL&file=Add&mode=API&to_user=[name]&password=[password]&url=%@

Vielen Dank an @jaegi für das herumtüfteln bis es korrekt ging! ;-)

POST Methode

Auch kannst Du die POST Methode mit Links wie http://krz.ch/?module=ShortURL&file=Add&mode=API nutzen

Folgende POST Variablen sind erlaubt:
url - einzelne URL Anfrage
tag - individuelle Tags (Bitte beachte: Falls die Tags genommen werden, wird eine Fehlermeldung statt die neue URL geliefert.)
pass - Passwort (nur Buchstaben und Zahlen sind erlaubt, keine Sonderzeichen)
validTill - Link Ablaufdatum - Format: 2008-12-05 (YYYY-MM-DD = Jahr-Monat-Tag)
bulk - bulk URLs (jede URL muss auf einer neuen Zeile beginnen)

Beispiele

Du findest hier ein Beispiel Script, wie Du das nutzen kannst: API Beispiel - URL kürzen

Du kannst das API aber auch so verwenden, dass gekürzte Links direkt an Twitter übergeben werden. Dazu verwendest Du diesen API Code:

</div>
</div>

<div id="footer">
<div class="wide"><center>
<a href="/?module=ContactUs">Kontakt</a> | 
<a href="/?module=Pages&id=23">Nutzungsbedingungen</a> | 
<a href="/?module=Pages&id=27">API</a>
  <br/> 
	Weitere Projekte von uns: <a href="http://www.flohmarkt24.ch" target="_blank" title="Gratis Inserate">Gratis Inserate Flohmarkt</a> | 
	<a href="http://www.swissblog.ch" target="_blank" title="Gratis Blog">Eigenen Blog starten</a> |
	<a href="http://www.vergleiche.ch/krankenkasse" target="_blank" title="Krankenkasse vergleichen">Krankenkassen vergleichen</a> |
        <a href="http://www.vergleiche.ch" target="_blank" title="Preisvergleich">Preisvergleich</a><br />
        <a href="http://www.vergleiche.ch/digitaltv" target="_blank" title="Digital TV Vergleich">Vergleich cablecom swisscom tv</a>
        <a href="http://www.schaetz-cro.ch" target="_blank" title="Conversion Rate Optimierung">CRO</a>
	<br/> 
	© 2009 - 2011 krz.ch | krz.ch ist ein Projekt der <a href="http://www.idealizer.ch" target="_blank" title="Idealizer AG - Schweizer eLab für online Medien">Idealizer AG</a>
</center> <script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-6674083-1");
pageTracker._trackPageview();
} catch(err) {}</script>

</div>
</body>
</html>