Вход · Забыли пароль? · Регистрация
Зарегистрируйтесь, и управляйте Вашими ссылками.
Зарегистрируйтесь, и отслеживайте переходы по Вашим ссылкам.

goID API

Для автоматизации процесса создания коротких ссылок вы можете использовать Web-сервис, либо специальную страницу, которая возвращает данные в текстовом виде.

 

Для сайтов PHP/Perl/Phyton/Ruby/Action Script (Flash)

Для получения короткой ссылки программно достаточно отправить запрос на специальную страницу – http://goid.ru/Shorten.aspx.

На запрос, страница возвращает текстовые данные, состоящие из двух строк. Первая строка – короткая ссылка. Вторая строка – сообщение об ошибке, если произошла ошибка, если все нормально, вторая строка будет пустой. В качестве разделителя используются символы CR LF.

Страница может принимать следующие параметры:

  • email и pwd - учетные данные пользователя goID.ru (опционально, если требуется статистика);
  • url - ссылка, которую нужно сократить;
  • method - метод редиректа (опционально). Может принимать значения 302 (по умолчанию) и 301;
  • dd - срок жизни ссылки (опционально). Дата в формате dd.mm.yyyy, не ниже текущей + 1 день;
  • urlpwd - пароль на ссылку (опционально).

 

Простой пример

http://goid.ru/Shorten.aspx?url=http://yandex.ru

 

Пример получения короткой ссылки на PHP

  // параметры
  $url = "http://localhost:13560/HTML/Test.aspx"; // ссылка, которую нужно сократить
  $method = 302; // метод перенаправления
  $email = ""; $pwd = ""; // емайл и пароль пользователя goid.ru, если требуется вести учет статистики ссылки
  $dd = ""; // срок жизни ссылки. Дата в формате dd.mm.yyy, например: 01.05.2008 - до первого мая 2008 года
  $urlpwd = "secret"; // пароль на короткую ссылку
  
  // делаем запрос на сервер goid.ru
  $result = file_get_contents("http://goid.ru/Shorten.aspx?url=$url&method=$method&email=$email&pwd=$pwd&dd=$dd&urlpwd=$urlpwd");

  list($shortUrl, $errorMessage) = split("\r\n", $result);
  if ($errorMessage!="")
  {
    echo "Короткая ссылка: $shortUrl";
  }
  else
  {
    echo "Ошибка: $errorMessage";
  }
  

 

Веб-сервис

Постоянный адрес веб-сервиса: http://goid.ru/WebService.asmx

Веб-сервис удобен для сайтов поддерживающих ASP .NET.

Для подключения веб-сервиса к сайту, запустите проект в Visual Studuo, выберите пункт меню WebSite (Веб-сайт) -> Add Web reference (Добавить веб-ссылку). В появившемся окне укажите адрес сервиса: http://goid.ru/WebService.asmx. Нажмите кнопку Add reference (Добавить ссылку).

Далее, в коде можно создавать экземпляр класса WebService, который имеет следующие функции: EasyShorten, EasyShorten301 и Shorten.

Самые простые функции - EasyShorten и EasyShorten301 принимают всего один параметр – длинный url.

Функция Shorten позволяет более гибко настраивать параметры кроткого url.

 

Простой пример использования веб-сервиса

В данном примере создается короткая ссылка при помощи функции EasyShorten.

C#:

ru.goID.WebService myGoID = new ru.goID.WebService();
ru.goID.WebService.Result myResult = myGoID.EasyShorten("http://localhost:13560/HTML/Test.aspx");
if (!String.IsNullOrEmpty(myResult.ErrorMessage))
{
  Response.Write("Ошибка: " + myResult.ErrorMessage);
}
else
{
  Response.Write("Короткий url: " + myResult.ShortUrl);
}
  

Visual Basic .NET:

Dim myGoID As New ru.goID.WebService()
Dim myResult As ru.goID.WebService.Result = myGoID.EasyShorten("http://localhost:13560/HTML/Test.aspx")
If Not String.IsNullOrEmpty(myResult.ErrorMessage) Then
  Response.Write("Ошибка: " & myResult.ErrorMessage)
Else
  Response.Write("Короткий url: " & myResult.ShortUrl)
End If
  

 

Продвинутый пример использования веб-сервиса

В данном примере создается короткая ссылка при помощи функции Shorten.

Короткая ссылка создается под учетной записью пользователя test@mail.ru (пароль: 111111). Это позволит пользователю test@mail.ru отслеживать статистику переходов по ссылке, а также изменять и удалять ссылку.

Перенаправление по короткой ссылке будет проходить с 302 HTTP-кодом. Параметр redirect_method также может принимать значение 301.

Срок жизни короткой ссылки неограничен.

На короткую ссылку установлен пароль - secret.

C#:
ru.goID.WebService myGoID = new ru.goID.WebService();
ru.goID.WebService.Result myResult = myGoID.Shorten("test@mail.ru", "111111", "http://localhost:13560/HTML/Test.aspx", 302, null, "secret");
if (!String.IsNullOrEmpty(myResult.ErrorMessage))
{
  Response.Write("Ошибка: " + myResult.ErrorMessage);
}
else
{
  Response.Write("Короткий url: " + myResult.ShortUrl);
}
  
Visual Basic .NET:
Dim myGoID As New ru.goID.WebService()
Dim myResult As ru.goID.WebService.Result = myGoID.Shorten("test@mail.ru", "111111", "http://localhost:13560/HTML/Test.aspx", 302, Nothing, "secret")
If Not String.IsNullOrEmpty(myResult.ErrorMessage) Then
  Response.Write("Ошибка: " & myResult.ErrorMessage)
Else
  Response.Write("Короткий url: " & myResult.ShortUrl)
End If