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-запроса

Например,
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 – признак успешности расшифровки короткой ссылки, где

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

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

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

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

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

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

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

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


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

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