LongURL API
LongURL API – интерфейс для разработчиков, позволяющий раскрывать короткие ссылки с помощью HTTP GET-запроса к сайту longurl.info (не чаще одного раза в 30 секунд).
HTTP GET-запрос, пример с пояснениями
Заголовок (Header)
GET https://longurl.info/api/2.0/?token=API_TOKEN&url=REQUEST_URL&antivirus=REQUEST_ANTIVIRUS
Параметры HTTP GET-запроса
- REQUEST_URL – короткая ссылка для расшифровки в виде строки
- REQUEST_ANTIVIRUS – если указано true, будет произведена антивирусная проверка конечного ресурса (после расшифровки короткой ссылки); если указано false, или параметр REQUEST_ANTIVIRUS пропущен, антивирусная проверка производиться не будет
- API_TOKEN – токен (ключ) авторизации пользователя, привязываемый к электронной почте (См.ниже)
Например,
GET https://longurl.info/api/2.0/?token=111&url=https://bit.ly/2QnxnNZ&antivirus=true
GET https://longurl.info/api/2.0/?token=111&url=https://bit.ly/2QnxnNZ&antivirus=false
GET https://longurl.info/api/2.0/?token=111&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
Введите E-mail для запроса токена