Добавление сведений о репутации веб-сайта

Запрос

Запрос на добавление сведений о репутации веб-сайта содержит следующие параметры:

• action – запрос на выполнение действия с Kaspersky Private Security Network (значение add_url).
• data.force – устранение конфликтов добавления репутации веб-сайта (необязательный параметр). Kaspersky Private Security Network проверяет наличие добавленных ранее сведений о репутации веб-сайта в локальной репутационной базе и сведений в базе Kaspersky Security Network (KL-репутация). Возможные значения:
  • true – изменение текущей репутации на репутацию в запросе в любом случае.
  • false – изменение текущей репутации на репутацию в запросе, только если в Kaspersky Private Security Network нет сведений о репутации веб-сайта. Если в Kaspersky Private Security Network уже добавлены сведения о веб-сайте, репутация не будет изменена. Значение по умолчанию.
• data.urls (массив):
  • data.urls.url – URL-адрес веб-сайта. URL-адрес должен удовлетворять требованию RFC 3986, допускается использование маски (*). При добавлении URL в локальную репутационную базу обрезаются все части URL, кроме доменной части и пути. Символ "*" используется как подстановочный символ: вместо одного или более символов.
  • data.urls.reputation – репутация веб-сайта. Возможные значения:
    • 1 – доверенный;
    • 2 – недоверенный.
  • data.urls.description – дополнительное описание веб-сайта (строка до 1024 символов).

Чтобы добавить сведения о репутации веб-сайта:

1. Запустите REST-клиент на любом компьютере локальной сети организации, имеющем доступ к серверу по используемому адресу Kaspersky Private Security Network.
2. В списке методов выберите метод POST.
3. В поле адреса запроса введите адрес, по которому доступен API KPSN.
4. В рабочей области введите тело запроса в формате JSON. См. пример ниже.
5. Отправьте запрос сервису URL Reputation.

   В окне REST-клиента отобразится ответ с результатом выполнения запроса.

Пример тела запроса

{

"action": "add_url",

"data": {

"force": false,

"urls": [

{

"url": "website1.com",

"reputation": 1,

"description": "social network"

},

{

"url": "website2.com",

"reputation": 2,

"description": "network game"

}

]

}

}

Ответ

Ответ содержит следующую информацию:

• data.url – URL-адрес веб-сайта (массив).
• data.publish_status – результат выполнения запроса. Возможные значения:
  • true – сведения о веб-сайте успешно добавлены в локальную репутационную базу.
  • false – добавить сведения о веб-сайте в локальную репутационную базу не удалось. В локальной репутационной базе уже содержатся сведения о веб-сайте. Чтобы изменить сведения о веб-сайте, необходимо установить для параметра data.force значение true.

Пример ответа

{

  "data": [

{

       "url": "website1.com",

   "publish_status": true

    },

   {

      "url": "website2.com",

      "publish_status": false

    }

  ]

}