Overview
Our API allows you to provide short url functionality to any of your existing websites. When you register for an account, you're generated a unique API key which should be used in the API calls listed below.
The examples below generate responses in json but you can also use xml by replacing the end of the url call with .xml.
Create
Create a new short url providing a base64 encoded version of the original long url.
Parameters:
Name: |
Type: |
Description: |
key |
string |
Your API access key. Görüntülemek için giriş yapın. |
url |
string |
Base64 encoded version of your long url. base64_encode() in PHP. |
Return Values:
Name: |
Type: |
Description: |
url_id |
integer |
Unique url id. |
short_url |
string |
Short url including domain name. |
short_url_part |
string |
Short url part. (excluding domain name) |
original_url |
string |
The original decoded long url. |
date_time |
string |
Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss. |
Example Request:
API Address: https://kisa.tk
GET //api/v1/b2df637977138814b0ed32f465581280/shorturl/create/url/BASE64_ENCODED_LONG_URL.json
Example Response:
{
"code":200,
"data":{
"url_id":"1388597",
"short_url":"https://kisa.tk/srt",
"short_url_part":"srt",
"original_url":"http://www.bbc.co.uk",
"date_time":"2013-04-04 16:18:05"
}
}
Oluştur (Ek Seçenekler)
Özel bir kısa url, erişim için şifre ve son kullanma tarihi gibi bazı ek ayarları içeren yeni bir kısa URL oluşturun.
Parameters:
Name: |
Type: |
Description: |
key |
string |
Your API access key. Görüntülemek için giriş yapın. |
url |
string |
Base64 encoded version of your long url. base64_encode() in PHP. |
custom_url (optional) |
string |
Custom short url part. |
password (optional) |
string |
URL'ye erişim şifresi. |
expiry_date (optional) |
string |
Date to expire the url. In the format yyyy-mm-dd. |
base_domain (optional) |
string |
Url to use for the short url. Must already exist on the site. No http or trailing forward slash. i.e. domain.com |
Return Values:
Name: |
Type: |
Description: |
url_id |
integer |
Unique url id. |
short_url |
string |
Short url including domain name. |
short_url_part |
string |
Short url part. (excluding domain name) |
original_url |
string |
The original decoded long url. |
date_time |
string |
Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss. |
Example Request:
API Address: https://kisa.tk
GET //api/v1/b2df637977138814b0ed32f465581280/shorturl/create/custom_url/CUSTOM_SHORT_URL/password/PASSWORD_TO_ACCESS/expiry_date/URL_EXPIRY_DATE/url/BASE64_ENCODED_LONG_URL.json
Example Response:
{
"code":200,
"data":{
"url_id":"1388598",
"short_url":"https://kisa.tk/bbc",
"short_url_part":"bbc",
"original_url":"http://www.bbc.co.uk",
"date_time":"2013-04-04 16:18:08"
}
}
Disable
Hesabınızda etkin bir kısa URL'yi devre dışı bırakın.
Parameters:
Name: |
Type: |
Description: |
key |
string |
Your API access key. Görüntülemek için giriş yapın. |
short_url |
string |
Base64 encoded version of your short url. base64_encode() in PHP. |
Return Values:
Name: |
Type: |
Description: |
url_id |
integer |
Unique url id. |
status |
string |
Kısa link durumu |
short_url |
string |
Short url including domain name. |
date_time |
string |
Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss. |
Example Request:
API Address: https://kisa.tk
GET //api/v1/b2df637977138814b0ed32f465581280/shorturl/disable/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
"code":200,
"data":{
"url_id":"1388598",
"status":"disabled",
"short_url":"https://kisa.tk/bbc",
"date_time":"2013-04-04 17:01:42"
}
}
Activate
Hesabınızda devre dışı bırakılmış bir kısa URL'yi etkinleştirin.
Parameters:
Name: |
Type: |
Description: |
key |
string |
Your API access key. Görüntülemek için giriş yapın. |
short_url |
string |
Base64 encoded version of your short url. base64_encode() in PHP. |
Return Values:
Name: |
Type: |
Description: |
url_id |
integer |
Unique url id. |
status |
string |
Kısa link durumu |
short_url |
string |
Short url including domain name. |
date_time |
string |
Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss. |
Example Request:
API Address: https://kisa.tk
GET //api/v1/b2df637977138814b0ed32f465581280/shorturl/enable/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
"code":200,
"data":{
"url_id":"1388598",
"status":"active",
"short_url":"https://kisa.tk/bbc",
"date_time":"2013-04-04 17:01:42"
}
}
Info
Get detailed information for any short url within your account.
Parameters:
Name: |
Type: |
Description: |
key |
string |
Your API access key. Görüntülemek için giriş yapın. |
short_url |
string |
Base64 encoded version of your short url. base64_encode() in PHP. |
Return Values:
Name: |
Type: |
Description: |
url_id |
integer |
Unique url id. |
short_url |
string |
Short url including domain name. |
short_url_part |
string |
Short url part. (excluding domain name) |
original_url |
string |
The original decoded long url. |
date_created |
string |
The date/time the short url was create. |
last_accessed |
string |
The date/time the short url was last accessed. |
total_visits |
integer |
Toplam Ziyaret |
has_password |
bool |
Whether the url needs a password to access. |
expiry_date |
string |
The date/time the short url will expire. |
status |
string |
Kısa link durumu |
date_time |
string |
Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss. |
Example Request:
API Address: https://kisa.tk
GET //api/v1/b2df637977138814b0ed32f465581280/shorturl/info/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
"code":200,
"data":{
"url_id":"13423436",
"short_url":"https://kisa.tk/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"
}
}
List
Hesabınızdaki tüm aktif url'leri listeleyin.
Parameters:
Name: |
Type: |
Description: |
key |
string |
Your API access key. Görüntülemek için giriş yapın. |
Return Values:
Name: |
Type: |
Description: |
urls |
array |
List of short urls within the account. |
date_time |
string |
Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss. |
Example Request:
API Address: https://kisa.tk
GET //api/v1/b2df637977138814b0ed32f465581280/shorturl/list_active_urls.json
Example Response:
{
"code":200,
"data":{
"urls":[
{
"short_url":"https://kisa.tk/2F"
},
{
"short_url":"https://kisa.tk/2q"
}
],
"date_time":"2013-04-09 09:48:05"
}
}