API (Russian)

Данная страница описывает технические возможности WOT API v0.4 и создана для разработчиков программ, использующих WOT.

Условия и положения
Перед тем, как продолжить, обратите внимание, что, помимо Условий использования, которые применимы ко всем сервисам WOT, существуют и Условия использования API.

Регистрация
Для использования API вам необходимо получить персональный API ключ. Для получения персонального ключа вам необходимо иметь учетную запись WOT. Если вы еще не регистрировались - пройдите процедуру регистрации, если у вас уже есть учетная запись WOT - вы можете запросить персональный API ключ перейдя по следующей ссылке.

После того, как вы запросили персональный API ключ, в вашем профиле появится новая вкладка, на которой вы можете посмотреть ваш API ключ и предоставить в WOT информацию об его использовании.

Введение
Система WOT вычисляет репутацию сайтов, используя рейтинги, полученные от пользователей, и информацию из сторонних источников. Этот раздел содержит краткое введение в некоторые понятия, которые необходимо знать для разработки приложений, использующих данные репутаций.

Хосты (targets)
Репутация вычисляется для сайтов, которые идентифицируются по их DNS имени. IPv4 или IPv6 адреса также могут быть использованы вместо имени. WOT так же поддерживает Internationalized Domain Names (IDN), которые должны быть закодированы в ASCII в соответствии с RFC 3490.

Например: ääkkönen.fi = xn--kknen-fraa0m.fi

Репутация
Репутация задается для хостов по двум компонентам. Для каждой пары {хост, компонент} система вычисляет два значения: Репутация и Уверенность в репутации. Вместе эти значения показывают степень доверия к хосту по соответствующему компоненту.

Компоненты
Компоненты репутации идентифицируются по номерам:

Примечание: Компоненты 1 и 2 являются устаревшими. API будет продолжать возвращать данные для этих компонентов для обеспечения совместимости, но эти компоненты не должны использоваться в новых приложениях. Тем, кто заинтересован в типе информации, которая включалась в устаревшие компоненты, рекомендуется изучить раздел категорий ниже.

Репутация и Уверенность
Репутация r ∊ {0, ..., 100} является оценкой коллективного доверия к цели по конкретному компоненту. Чем выше значение, тем больше сообщество доверяет сайту. Описания для различных значений репутации приведены в таблице:

WOT использует визуальное представление для индикации репутации (эта картинка поясняет структуру):

Уверенность "c" ∊ {0, ..., 100} показывает оценку надежности репутации для пары {цель, компонент}. Чем выше значение, тем выше уверенность в оценке репутации. Вы должны использовать показатель уверенности для исключения ложных срабатываний (репутацию при "c" < 6 нельзя считать сколь-нибудь надежной). Например, для расширения WOT требуется значение уверенности ≥ 10 для того, чтобы показать окно предупреждения о отрываемом сайте. Использование высокого порога уверенности приведет к уменьшению ложных срабатываний, но также приведет к тому, что приложение будет меньше реагировать на сайты с плохой репутацией. Вы можете экспериментировать с разными порогами уверенности, чтобы увидеть, который наилучшим образом соответствует вашему приложению. Мы рекомендуем порог от 12 до 20 для отображения предупреждения.

Категории
В дополнение к репутации, система также вычисляет категорий для сайтов на основе голосов от пользователей и доверенных источников данных. Категории призваны объяснить причину плохой репутации. Текущие категории:

Следующие категории предоставляют информацию о безопасности для детей:

Для каждой категории Система репутаций также вычисляет значение  уверенности "ε" {0, ..., 100}, как и для репутации. Чем выше значение, тем выше надежность присвоенной категории. Если вы используете категории для определения категории тяжести плохой репутации, вы можете использовать более низкий порог уверенность для категоризации данных. Система выдает категорию при "c" > 3. Для принятия решения в вашем продукте мы рекомендуем опираться на категории с "c" > 6.

WOT использует визуальное представление для категории групп и их уверенности:

Сторонние источники данных
Если веб-сайт находится в стороннем черном списке и это влияет на репутацию сайта, то API возвращает информацию о типе черного списка, в котором сайт был найден. Ниже приведен список типов черных списков:

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

Запросы
API состоит из нескольких интерфейсов, каждый из которых вызывается использованием обычных HTTP GET запросов к api.mywot.com и возвращающих ответ в формате JSON в случае успешного выполнения. Коды статуса HTTP используются для возвращения информации об ошибках, параметры передаются с использованием стандартных конвенций URL. Формат запроса выглядит следующим образом:

http://api.mywot.com/version/interface?param1=value1&param2=value2

TLS шифрование может быть использовано со всеми интерфейсами.

public_link_json2
Public_link_json2 API используется для запроса репутации для нескольких хостов.

Коды возврата
Если запрос был успешным, то возвращается HTTP код 200. Если произошла ошибка на стороне сервера - код 500. Если запрос содержал некорректный ключ API или некорректный параметр, код статуса будет 403. Если вы превысили дневной лимит, вернётся код 429.

Возвращаемые данные
API возвращает репутацию, категории и информацию о сторонних источниках данных в формате JSON или JSONP в зависимости от параметра обратного вызова, указанного в запросе. Формат выглядит следующим образом:
 * 1) Объект ответа имеет один атрибут для каждого домена, названный неизмененным именем заданного параметром хоста.
 * 2) Каждый целевой объект имеет целевой атрибут, который содержит нормализованное название цели.
 * 3) Каждый целевой объект также имеет атрибуты компонентов,  ∊ {“0”, ...}.
 * 4) Каждый атрибут компонента содержит массив с значениями {r, c} для репутации компонента. Если репутация для компонента неизвестна, соответствующего атрибута в ответе не будет.
 * 5) Каждый целевой объект также может иметь атрибут категории, который содержит один или более идентификатор атрибутов категории и их значения уверенности.
 * 6) Каждый целевой объект также может иметь атрибут черного списка, который содержит один или более типов черного списка и Unix-метку времени, когда сайт был последний раз добавлен в список сторонних источников данного типа.

Пример
Запрос: http://api.mywot.com/0.4/public_link_json2?hosts=example.COM/www.EXAMPLE.NET/&callback=process&key= Ответ: process({   " example.COM ": {      " target ": " example.com ",      " 0 ": [ 91, 53 ],      " 4 ": [ 93 , 53 ],      " categories ": {        " 501 ": 71 ,        " 304 ": 37       }    },    " www.EXAMPLE.NET ": {      " target ": " example.net ",      " 0 ": [ 9 , 43 ],      " categories ": {        " 101 ": 54       },      " blacklists ": {        " malware ": 1362123608       }    }  })