GOO-GL.RU API

Обзор

Наш API позволяет вам предоставлять функциональные возможности сокращения url ссылок на любом из существующих веб-сайтов. Когда вы регистрируете учетную запись, вы создаете уникальный ключ API, который должен использоваться в вызовах API, перечисленных ниже.

Нижеприведенные примеры генерируют ответы в json, но вы также можете использовать xml, заменив конец URL-адреса на .xml.


Create

Создайте новый короткий URL-адрес, предоставляющий кодированную версию с исходным кодом оригинального длинного URL-кода.

Parameters:
Name: Type: Description:
key string Your API access key. Login to view.
url string Base64 - кодированная версия вашего длинного URL-адреса. base64_encode () в 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://goo-gl.ru
GET //api/v1/1d5bd09671e9b4f0eb568e0defe03963/shorturl/create/url/BASE64_ENCODED_LONG_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"1388597",
      "short_url":"https://goo-gl.ru/srt",
      "short_url_part":"srt",
      "original_url":"http://www.bbc.co.uk",
      "date_time":"2013-04-04 16:18:05"
   }
}

Создать (Дополнительные Опции)

Создайте новый короткий URL-адрес, включая некоторые дополнительные настройки, например пользовательский короткий URL-адрес, пароль для доступа и дату истечения срока действия.

Parameters:
Name: Type: Description:
key string Your API access key. Login to view.
url string Base64 - кодированная версия вашего длинного URL-адреса. base64_encode () в PHP.
custom_url (Необязательный) string Custom short url part.
password (Необязательный) string Password to access url.
expiry_date (Необязательный) string Date to expire the url. In the format yyyy-mm-dd.
base_domain (Необязательный) string Url использовать для короткого URL. Должен уже существовать на сайте. Нет http или / (трейлинг-косой черты) т.е. 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://goo-gl.ru
GET //api/v1/1d5bd09671e9b4f0eb568e0defe03963/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://goo-gl.ru/bbc",
      "short_url_part":"bbc",
      "original_url":"http://www.bbc.co.uk",
      "date_time":"2013-04-04 16:18:08"
   }
}

Запрещен

Отключите активный короткий URL-адрес в своей учетной записи.

Parameters:
Name: Type: Description:
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:
Name: Type: Description:
url_id integer Unique url id.
status string Статус коротко Url
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://goo-gl.ru
GET //api/v1/1d5bd09671e9b4f0eb568e0defe03963/shorturl/disable/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "status":"disabled",
      "short_url":"https://goo-gl.ru/bbc",
      "date_time":"2013-04-04 17:01:42"
   }
}

Активировать

Активируйте отключенный короткий URL-адрес в своей учетной записи.

Parameters:
Name: Type: Description:
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:
Name: Type: Description:
url_id integer Unique url id.
status string Статус коротко Url
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://goo-gl.ru
GET //api/v1/1d5bd09671e9b4f0eb568e0defe03963/shorturl/enable/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"1388598",
      "status":"active",
      "short_url":"https://goo-gl.ru/bbc",
      "date_time":"2013-04-04 17:01:42"
   }
}

инфо

Get detailed information for any short url within your account.

Parameters:
Name: Type: Description:
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:
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 Дата / время создания короткого URL.
last_accessed string Дата / время последнего обращения к url.
total_visits integer Число посещений
has_password bool Whether the url needs a password to access.
expiry_date string Дата / время истечения короткого URL-адреса.
status string Статус коротко 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://goo-gl.ru
GET //api/v1/1d5bd09671e9b4f0eb568e0defe03963/shorturl/info/short_url/BASE64_ENCODED_SHORT_URL.json
Example Response:
{
   "code":200,
   "data":{
      "url_id":"13423436",
      "short_url":"https://goo-gl.ru/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

Список всех активных URL-адресов в вашей учетной записи.

Parameters:
Name: Type: Description:
key string Your API access key. Login to view.
Return Values:
Name: Type: Description:
urls массив 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://goo-gl.ru
GET //api/v1/1d5bd09671e9b4f0eb568e0defe03963/shorturl/list_active_urls.json
Example Response:
{
   "code":200,
   "data":{
      "urls":[
         {
            "short_url":"https://goo-gl.ru/2F"
         },
         {
            "short_url":"https://goo-gl.ru/2q"
         }
      ],
      "date_time":"2013-04-09 09:48:05"
   }
}