4. Как насчет API? - Мурл

Да, Мурл поддерживает обращение через API.

Описание API-интерфейса

На данный момент поддерживается только мурлификация ссылок.

Запросы происходят через протокол HTTP по методу GET.
Использование API возможно только при наличии API-ключа. Для того, чтобы его получить, отправьте заявку по адресу: support[гав!]murl.kz с пометкой "API".

Как получить короткую ссылку (базовый метод)

Формат запроса:

Для этого необходимо отправить запрос по адресу http://api.murl.kz/basic со следующими параметрами:

format - Формат ответа: xml, json или plain-текст. По умолчанию - xml.
url - Длинный адрес URL
api_key - Ключ API
callback - Только для формата ответа json. Должен быть равен "?".

Поля ответа:

status - Статус ответа, содержит результат запроса (result), код ответа (code) и читабельное сообщение (message).
url - Мурлифицированный URL. Обратите внимание, что если в url присутствуют спец-символы (? или &), то этот параметр должен кодироваться. При обработке Мурл сам его раскодирует.
murlpath - Алиас короткой ссылки

Пример запроса (XML):

http://api.murl.kz/basic?format=xml&url=http://ru.wikipedia.org/wiki/Аральское_море

Ответ (XML):

<?xml version="1.0" encoding="utf-8"?>

<murl>

</murl>

Пример запроса (json):

http://api.murl.kz/basic?format=json&url=http://ru.wikipedia.org/wiki/Аральское_море&callback=?

Ответ (json):

jsonp1241204921957({"murl":{"status":{"code":200,"result":"OK","message":"URL \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d."},"url":"http:\/\/murl.kz\/tRpb","murlpath":"tRpb"}})

Пример запроса (plain-текст):

http://api.murl.kz/basic?format=text&url=http%3A%2F%2Fya.ru

Ответ (plain-текст):

http://murl.kz/KeMW

Как получить базовую статистику по API-ключу

Получите количество мурлифицированных ссылок по Вашему API-ключу.

Формат запроса:

Для этого необходимо отправить запрос по адресу http://api.murl.kz/userstat с единственным параметром:

api_key - Ключ API

Поля ответа:

status - Статус ответа, содержит результат запроса (result), код ответа (code) и читабельное сообщение (message).
count - Количество ссылок, мурлифицированных через данный API-ключ.

Пример запроса (XML):

http://api.murl.kz/userstat?api_key=<ключ>

Ответ (XML):

<?xml version="1.0" encoding="utf-8"?>

<murl>

</murl>

Коды ответа

Мурл адекватно реагирует на ошибки, но как разобрать его мурлыканье? Воспользуйтесь шпаргалкой ниже, чтобы понять, как он реагирует на Ваши запросы:

200 - Запрос выполнен. Адрес успешно добавлен.
201 - Запрос выполнен. Статистика отправлена.
400 - Запрос не выполнен. Не задан требуемый URL.
401 - Запрос не выполнен. Указанный URL запрещен. Мурл не воспринимает уже укороченные ссылки.
402 - Запрос не выполнен. Неверный формат URL.
403 - Запрос не выполнен. Не задан ключ API.
404 - Запрос не выполнен. Указан неверный ключ API. Его просто нет в нашей базе.

Версия:

6. Интеграция с TweetDeck Desktop	19 июл
4. Как насчет API?	19 июл
5. Примеры использования API	1 авг
3. Я хочу пожаловаться на спам, куда мне обратиться?	1 май
2. Как долго хранятся ссылки?	1 май
1. Что такое "Мурл"?	1 май
murlogo_green.jpg	1 май
murlogo_white.gif	1 май