API - интерфейс разработчика

LongURL API

LongURL API – интерфейс для разработчиков, позволяющий раскрывать короткие ссылки с помощью HTTP GET-запроса к сайту longurl.info.

HTTP GET-запрос, пример с пояснениями

Заголовок (Header)

GET https://longurl.info/api/2.0/?url=REQUEST_URL&antivirus=REQUEST_ANTIVIRUS

Параметры HTTP GET-запроса

REQUEST_URL – короткая ссылка для расшифровки в виде строки
REQUEST_ANTIVIRUS – если указано true, будет произведена антивирусная проверка конечного ресурса (после расшифровки короткой ссылки); если указано false, или параметр REQUEST_ANTIVIRUS пропущен, антивирусная проверка производиться не будет

Например,
GET https://longurl.info/api/2.0/?url=https://bit.ly/2QnxnNZ&antivirus=true
GET https://longurl.info/api/2.0/?url=https://bit.ly/2QnxnNZ&antivirus=false
GET https://longurl.info/api/2.0/?url=https://bit.ly/2QnxnNZ

HTTP GET-ответ, пример с пояснениями

Заголовок (Header)

HTTP/1.1 200 OK
Content-Type: application/json

Тело HTTP GET-ответа

Тело ответа рассмотрим на основе вышеперечисленных примерах HTTP GET-запросов


    {

        "success": true,

        "url": ["http://example.com"],

        "antivirusStatus": 0,

        "antivirusMessage": "HTML_BODY",

        "safeBrowsing": true

    }

Как видно, ответ передается в виде JSON-строки.

Поля и значения полей HTTP GET-ответа

success – признак успешности расшифровки короткой ссылки, где

true – успешно
false – произошла какая-то ошибка, возможно, неверный формат запроса

url – массыв с расшифрованными короткими ссылками, если определена цепочка перенаправлений, массив будет содержать несколько элементов

antivirusStatus (*) – результат антивирусной проверки, где

0 – вирусов не обнаружено
1 – обнаружены вирусы
2 – произошла ошибка в процессе антивирусной проверки, например, целевой ресурс недоступен

Примечание. Если антивирусная проверка не выполнялась, т.е. параметр antivirus в HTTP GET-запросе равнялся false, значение поля antivirusStatus всегда будет 2

antivirusMessage – подробности (лог) проверки ресурса

Внимание. Тело значения поля antivirusMessage представлено полноценной HTML-строкой, необходимо учитывать данный факт при необходимости вывода ответа на стороне клиента.

safeBrowsing (**) – результат проверки ресурса по базе данных потенциально вредоносных сайтов Google, где

true – ресурс безопасен
false – ресурс может представлять угрозу

Примечание. Если антивирусная проверка не выполнялась, т.е. параметр antivirus в HTTP GET-запросе равнялся false, значение поля safeBrowsing всегда будет false

Примечание. Если определена цепочка перенаправлений, антивирусную проверку будет проходить только последний ресурс в данной цепочке (т.е. последний элемент в массиве url)

(*) – сканирование ресурса на вирусы происходит с помощью Dr.Web

(**) – проверка потенциально небезопасных ресурсов происходит с помощью технологии Google Safe Browsing