fluub.de API

Überblick

Unsere API ermöglicht es Ihnen, Kurz-URL-Funktionalität für ihre Webseite zu nutzen. Wenn sie einen Account erstellen, erhalten sie einen einzigartigen API-Schlüssel, welchen sie dazu nutzen können um Anfrage an die API zu erstellen.

Die folgenden Beispiele erzeugen Antworten in json, aber Sie können auch XML erstellen indem sie am Ende der URL ein Xml einsetzen.


Erstellen

Erstellen Sie einen neuen Kurz-URL die eine Base64-codierte Version der ursprünglichen lange URL darstellt.

Parameter:
Name: Typ: Beschreibung:
key string Dein API access key. Login to view.
url string Base64-codierte Version der langen URL. base64_encode() in PHP.
Rückgabewerte:
Name: Typ: Beschreibung:
url_id ganze zahl Einzigartige url id.
short_url string Short URL einschließlich Domain-Namen.
short_url_part string Short URL Anteil. (ohne den Domänennamen)
original_url string Die ursprüngliche decodiert lange URL.
date_time string Datum und Zeit des API aufrufes. Im Format yyyy-mm-dd hh:mm:ss.
Beispiel Anforderung:
API Adresse: http://fluub.de
GET //api/v1/1bf7b155d3cb6d0c8ad14bbad0aadb80/shorturl/create/url/BASE64_ENCODED_LONG_URL.json
Beispielantwort:
{
   "code":200,
   "data":{
      "url_id":"1388597",
      "short_url":"http://fluub.de/srt",
      "short_url_part":"srt",
      "original_url":"http://www.bbc.co.uk",
      "date_time":"2013-04-04 16:18:05"
   }
}

Erstelle (Additional Options)

Create a new short url including some additional settings such as a custom short url, password to access and an expiry date.

Parameter:
Name: Typ: Beschreibung:
key string Dein API access key. Login to view.
url string Base64-codierte Version der langen URL. base64_encode() in PHP.
custom_url (optional) string Kundenspezifische short - URL Teil.
password (optional) string Passwort um auf die URL zugreiffen zu können
expiry_date (optional) string Ablaufdatum der URL. Im Format yyyy-mm-dd.
base_domain (optional) string URL für die Nutzung der short - URL. Kein http oder nachgestellte Schrägstrich. Beispiele: domain.de
Rückgabewerte:
Name: Typ: Beschreibung:
url_id ganze zahl Einzigartige url id.
short_url string Short URL einschließlich Domain-Namen.
short_url_part string Short URL Anteil. (ohne den Domänennamen)
original_url string Die ursprüngliche decodiert lange URL.
date_time string Datum und Zeit des API aufrufes. Im Format yyyy-mm-dd hh:mm:ss.
Beispiel Anforderung:
API Adresse: http://fluub.de
GET //api/v1/1bf7b155d3cb6d0c8ad14bbad0aadb80/shorturl/create/custom_url/CUSTOM_SHORT_URL/password/PASSWORD_TO_ACCESS/expiry_date/URL_EXPIRY_DATE/url/BASE64_ENCODED_LONG_URL.json
Beispielantwort:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "short_url":"http://fluub.de/bbc",
      "short_url_part":"bbc",
      "original_url":"http://www.bbc.co.uk",
      "date_time":"2013-04-04 16:18:08"
   }
}

Deaktivieren

Disable an active short url within your account.

Parameter:
Name: Typ: Beschreibung:
key string Dein API access key. Login to view.
short_url string Base64-codierte Version der short - URL. base64_encode() in PHP.
Rückgabewerte:
Name: Typ: Beschreibung:
url_id ganze zahl Einzigartige url id.
status string Short url Status.
short_url string Short URL einschließlich Domain-Namen.
date_time string Datum und Zeit des API aufrufes. Im Format yyyy-mm-dd hh:mm:ss.
Beispiel Anforderung:
API Adresse: http://fluub.de
GET //api/v1/1bf7b155d3cb6d0c8ad14bbad0aadb80/shorturl/disable/short_url/BASE64_ENCODED_SHORT_URL.json
Beispielantwort:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "status":"disabled",
      "short_url":"http://fluub.de/bbc",
      "date_time":"2013-04-04 17:01:42"
   }
}

Aktivieren

Activate a disabled short url within your account.

Parameter:
Name: Typ: Beschreibung:
key string Dein API access key. Login to view.
short_url string Base64-codierte Version der short - URL. base64_encode() in PHP.
Rückgabewerte:
Name: Typ: Beschreibung:
url_id ganze zahl Einzigartige url id.
status string Short url Status.
short_url string Short URL einschließlich Domain-Namen.
date_time string Datum und Zeit des API aufrufes. Im Format yyyy-mm-dd hh:mm:ss.
Beispiel Anforderung:
API Adresse: http://fluub.de
GET //api/v1/1bf7b155d3cb6d0c8ad14bbad0aadb80/shorturl/enable/short_url/BASE64_ENCODED_SHORT_URL.json
Beispielantwort:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "status":"active",
      "short_url":"http://fluub.de/bbc",
      "date_time":"2013-04-04 17:01:42"
   }
}

Info

Get detailed information for any short url within your account.

Parameter:
Name: Typ: Beschreibung:
key string Dein API access key. Login to view.
short_url string Base64-codierte Version der short - URL. base64_encode() in PHP.
Rückgabewerte:
Name: Typ: Beschreibung:
url_id ganze zahl Einzigartige url id.
short_url string Short URL einschließlich Domain-Namen.
short_url_part string Short URL Anteil. (ohne den Domänennamen)
original_url string Die ursprüngliche decodiert lange URL.
date_created string Datum / Uhrzeit wann die short - URL erstellt wurde.
last_accessed string Datum / Uhrzeit wann die short - URL zuletzt aufgerufen wurde.
total_visits ganze zahl Besucher insgesamt
has_password bool Du benötigst ein Passwort um auf diese URL Zugriff zu bekommen
expiry_date string Datum / Uhrzeit wann die short - URL abläuft.
status string Short url Status.
date_time string Datum und Zeit des API aufrufes. Im Format yyyy-mm-dd hh:mm:ss.
Beispiel Anforderung:
API Adresse: http://fluub.de
GET //api/v1/1bf7b155d3cb6d0c8ad14bbad0aadb80/shorturl/info/short_url/BASE64_ENCODED_SHORT_URL.json
Beispielantwort:
{
   "code":200,
   "data":{
      "url_id":"13423436",
      "short_url":"http://fluub.de/bbc",
      "short_url_part":"bbc",
      "original_url":"http://www.bbc.co.uk",
      "date_created":"2013-04-04 12:36:09",
      "last_accessed":"2013-05-02 12:32:05",
      "total_visits":"3452",
      "has_password":true,
      "expiry_date":"2019-03-02 23:59:59",
      "status":"active",
      "date_time":"2013-04-04 17:10:14"
   }
}

Auflistung

List all active urls within your account.

Parameter:
Name: Typ: Beschreibung:
key string Dein API access key. Login to view.
Rückgabewerte:
Name: Typ: Beschreibung:
urls feld Liste der Kurz URLs innerhalb ihres Kontos.
date_time string Datum und Zeit des API aufrufes. Im Format yyyy-mm-dd hh:mm:ss.
Beispiel Anforderung:
API Adresse: http://fluub.de
GET //api/v1/1bf7b155d3cb6d0c8ad14bbad0aadb80/shorturl/list_active_urls.json
Beispielantwort:
{
   "code":200,
   "data":{
      "urls":[
         {
            "short_url":"http://fluub.de/2F"
         },
         {
            "short_url":"http://fluub.de/2q"
         }
      ],
      "date_time":"2013-04-09 09:48:05"
   }
}