Сокращение ссылки с помощью 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 ошибок, пожалуйста, обратитесь в поддержку.

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

Расширение для GOOGLE CHROME - Укоротитель ссылок GOO.SU

Сокращайте ссылки с помощью нашего расширения

Специально для Вас, мы создали удобное расширение для Google Chrome. Установив наше расширение для браузера, вы сможете сокращать или укорачивать ссылки с любых сайтов одним кликом мыши.

Установить