Сокращение ссылки с помощью API

На севисе goo.su реализовано простое api, которое позволяет удаленно создавать короткие ссылки.

Использование API совершенно бесплатное.

Для того, чтобы начать сокращать ссылки с помощью API, вам необходимо зарегистрироваться, затем на странице API получить Ваш ключ доступа.
Обязательным параметром является token и url , где token - Ваш секретный ключ , url - URL адрес, который необходимо сократить

Дополнительные параметры:

• alias (string) - значение, которое вы бы хотели видеть, в качестве короткой ссылки. Напимер, указав alias=cool, ваша ссылка будет выглядеть следующим образом: https://goo.su/cool.
  Данный параметр не обязателен. Максимальная длина 10 символов. Значение алиаса должно быть уникально, если в системе такой алиас уже используется, будет возвращена соответствующая ошибка.
• password (string) - Пароль для перехода на страницу. Если вы хотите ограничить доступ к сокращаемому URL для определенного круга лиц, установите свой пароль. В таком случае, при переходе по короткой ссылке, пользователю будет предложено ввести пароль. В случае успешной проверки будет осуществлен переход на требуемую страницу, иначе, доступ будет ограничен.
  Данный параметр не обязателен.
• is_public (boolean) - значение, которое определяет доступность ссылки для всего интернета. Указав значение false, ссылка не будет отображаться на сайте и не будет индексироваться поисковыми системами.
  Данный параметр не обязателен. Значение по умолчанию - true.

Примеры запроса:

• CURL:
  curl --request GET \ --url 'https://goo.su/api/convert?url=https://site.com&alias=cool'
• PHP:
  
$client = new http\Client;
$request = new http\Client\Request;
$body = new http\Message\Body;
$body->append(new http\QueryString(array(
   'url' => 'https://site.com',
  'is_public' => true
)));
$request->setRequestUrl('https://goo.su/api/convert');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders(array(
  'content-type' => 'application/x-www-form-urlencoded'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();


, где https://site.com - url, который необходимо сократить.
Обратите внимание, что в случае, если в параметре url не был передан протокол (http:// или https://), будет автоматически подставлен протокол http:// .

Успешный ответ.

В случае успеха, сервер вернет код 200 (OK) с телом в формате JSON.
Например:
{
 "link": {
      "long_url": "https://site.com",
      "short": "0e3",
      "hits": 0
 },
 "short_url": "https://goo.su/0e3",
 "succes": true
}


Ошибки.

В случае возникновения ошибки, сервер вернет код ошибки с телом в формате JSON, с указанием причины ошибки.

Возможные коды ошибок:

• 422 (Unprocessable Entity) - Неверно заполнены поля или ошибка валидации.
  Пример:
  {
  "message": "Неверно заполнены поля",
  "errors": {
    "url": [
      "Неверный формат URL"
    ]
  }
}

• 404 (Not found)
  Ошибка при написании URL запроса. В данном случае, перепроверьте правильность указанного в запросе URL (https://goo.su/api/convert)
• 400 (Bad request)
  Неверный запрос. Причиной данной ошибки может быть причина сократить ссылку, которая ссылается на сервер Goo.su. Другими словами, запрещено сокращать ссылки для данного сайта.
• 50* (Server Error)
  В случае возникновения 500-505 ошибок, пожалуйста, обратитесь в поддержку.

В случае возникновения вопросов обращайтесь в поддержку сайта, мы будем рады Вам помочь.