API

API сервиса коротких ссылок RLU.Ru достачно простое. Для использования необходимо отправить следующий GET-запрос:

http://rlu.ru/index.sema?a=api&del=10&preview=1&link=http%3A%2F%2Fgoogle.com

Параметры в запросе означают следующее:

a=api — зарезервированный параметр, менять нельзя.
del=10 — через сколько часов ссылка должна перестать работать. Если нужна вечная ссылка, то этот параметр нужно либо вообще не указывать, либо передавать del=0. Допустимые значения от 0 до 720. В данном примере ссылка будет удалена через 10 часов. Для платных ссылок (о которых написано ниже) этот параметр не используется, платные ссылки нельзя создать автоматически удаляемые.
preview=1 — получать ссылку на страницу с предварительным просмотром, откуда уже можно перейти на указанную ссылку, или сразу прямую ссылку (если параметр не передаётся или preview=0).
link=http%3A%2F%2Fgoogle.com — передаётся адрес длинной ссылки. В данном примере передаётся адрес http://google.com.

Обязательные параметры, которые должны быть в любом запросе: a=api и link=[адрес ссылки].

Если запрос передан правильный, в ответ будет выдана короткая ссылка примерно такого вида:

http://rlu.ru/1a2b3

Если запрос ошибочный (например, нет адреса длинной ссылки), то в ответе будет указан текст ошибки (в кодировке UTF8), всегда начинающийся с «Error: ». Например:

Error: Неправильный адрес длинной ссылки.

Пример на PHP:

<?php
$res=file_get_contents('http://rlu.ru/index.sema?a=api&link='.urlencode('http://google.com'));
$pos=strpos($res,'Error: ');
if ($res=='' || $pos!==false && $pos==0) echo 'Произошла ошибка. '.$res;
else echo 'Короткая ссылка: '.$res;
?>

Пример на Perl:

#!/usr/bin/perl
use LWP::UserAgent;
use URI::Escape
my $ua = LWP::UserAgent->new;
my $response=$ua->get('http://rlu.ru/index.sema?a=api&link='.uri_escape('http://google.com'));
my $res=$response->content;
if ($res eq '' || $res=~/^Error: /) { print 'Произошла ошибка. '.$res; }
else { print 'Короткая ссылка: '.$res; }

Внимание! При большом количестве запросов, поступающих с одного IP-адреса, он может быть заблокирован. Если вы планируете добавлять более 100 ссылок в час, пожалуйста, свяжитесь с поддержкой, чтобы не произошло неожиданной блокировки вашего IP и удаления всех ссылок, добавленных вами ранее.