Kısa Link - Short URL API

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.


Oluştur

Create a new short url providing a base64 encoded version of the original long url.

Parameters:
Isim: Tip: Açıklama:
key string Your API access key. Login to view.
url string Base64 encoded version of your long url. base64_encode() in PHP.
Return Values:
Isim: Tip: Açıklama:
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: http://url.mybb.biz
GET //api/v1/0e7611e563abd38b05a19cb0b8ba8347/shorturl/create/url/BASE64_ENCODED_LONG_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"1388597",
      "short_url":"http://url.mybb.biz/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)

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

Parameters:
Isim: Tip: Açıklama:
key string Your API access key. Login to view.
url string Base64 encoded version of your long url. base64_encode() in PHP.
custom_url (isteğe bağlı) string Custom short url part.
password (isteğe bağlı) string Password to access url.
expiry_date (isteğe bağlı) string Date to expire the url. In the format yyyy-mm-dd.
base_domain (isteğe bağlı) 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:
Isim: Tip: Açıklama:
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: http://url.mybb.biz
GET //api/v1/0e7611e563abd38b05a19cb0b8ba8347/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":"http://url.mybb.biz/bbc",
      "short_url_part":"bbc",
      "original_url":"http://www.bbc.co.uk",
      "date_time":"2013-04-04 16:18:08"
   }
}

Hizmet Dışı Bırakma

Disable an active short url within your account.

Parameters:
Isim: Tip: Açıklama:
key string Your API access key. Login to view.
short_url string Base64 encoded version of your short url. base64_encode() in PHP.
Return Values:
Isim: Tip: Açıklama:
url_id integer Unique url id.
status string Short url status.
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: http://url.mybb.biz
GET //api/v1/0e7611e563abd38b05a19cb0b8ba8347/shorturl/disable/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "status":"disabled",
      "short_url":"http://url.mybb.biz/bbc",
      "date_time":"2013-04-04 17:01:42"
   }
}

Etkinleştirme

Activate a disabled short url within your account.

Parameters:
Isim: Tip: Açıklama:
key string Your API access key. Login to view.
short_url string Base64 encoded version of your short url. base64_encode() in PHP.
Return Values:
Isim: Tip: Açıklama:
url_id integer Unique url id.
status string Short url status.
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: http://url.mybb.biz
GET //api/v1/0e7611e563abd38b05a19cb0b8ba8347/shorturl/enable/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "status":"active",
      "short_url":"http://url.mybb.biz/bbc",
      "date_time":"2013-04-04 17:01:42"
   }
}

Bilgi

Get detailed information for any short url within your account.

Parameters:
Isim: Tip: Açıklama:
key string Your API access key. Login to view.
short_url string Base64 encoded version of your short url. base64_encode() in PHP.
Return Values:
Isim: Tip: Açıklama:
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 Short url status.
date_time string Date and time of the API call. In the format yyyy-mm-dd hh:mm:ss.
Example Request:
API Address: http://url.mybb.biz
GET //api/v1/0e7611e563abd38b05a19cb0b8ba8347/shorturl/info/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"13423436",
      "short_url":"http://url.mybb.biz/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"
   }
}

Listeleme

List all active urls within your account.

Parameters:
Isim: Tip: Açıklama:
key string Your API access key. Login to view.
Return Values:
Isim: Tip: Açıklama:
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: http://url.mybb.biz
GET //api/v1/0e7611e563abd38b05a19cb0b8ba8347/shorturl/list_active_urls.json
Example Response:
{
   "code":200,
   "data":{
      "urls":[
         {
            "short_url":"http://url.mybb.biz/2F"
         },
         {
            "short_url":"http://url.mybb.biz/2q"
         }
      ],
      "date_time":"2013-04-09 09:48:05"
   }
}

Copyright © 2017 - MyBB Link Kısaltma Servisi. Tüm hakları saklıdır.