Статусы ответов

В этом разделе описываются статусы ответов REST API Kaspersky CyberTrace.

Дополнительные сведения об ответах приведены в описании отдельных запросов.

200 OK

Этот статус возвращается для запросов, которые были успешно обработаны. В теле ответа содержится результат.

201 Created

Этот статус возвращается, когда успешно создается объект (источник данных об угрозах или индикатор). В теле ответа содержится статус операции.

202 Partial success

Этот статус возвращается, когда успешно создано только подмножество объектов (индикаторов). В теле ответа содержится статус операции и информация об объектах, которые не были обработаны.

401 Unauthorized user

Пользователь не авторизован, указанный пользователь не существует или пароль, указанный в заголовке авторизации, недействителен.

Примеры:

• Этот статус возвращается запросом без заголовка Authorization.
• Этот статус возвращается запросом с попыткой авторизации для несуществующей учетной записи пользователя.

403 User does not have rights to this operation

У пользователя нет прав на выполнение этой операции. Это может произойти, например, когда лицензионный ключ не включает поиск индикаторов, или когда пользователь с ролью «Аналитик» пытается добавлять индикаторы или новый источник данных об угрозах.

В теле ответа может содержаться описание ошибки.

404 Request not supported

Указанный запрос или версия API не поддерживается.

Примеры:

• Запрос login не поддерживается. Запрос POST /api/1.0/login возвращает этот статус.
• Версия API 8.0 не поддерживается. POST/api/8.0/lookup возвращает этот статус.

405 Method Not Allowed

Указанный метод не поддерживается.

Например, запрос lookup поддерживает только метод POST. Запрос GET/api/1.1/lookup возвращает этот статус.

425 Kaspersky CyberTrace initializing

Запрос был сделан в момент, когда инициализация Kaspersky CyberTrace еще не была завершена.

406 Not Acceptable

Указанный формат данных не поддерживается.

Например, если заголовок «Accept» содержит значение «application/pdf», ответ возвращает этот статус.

429 Too Many Requests

Kaspersky CyberTrace не может обработать запрос.

Запрос отклонен и не обрабатывается. Следует повторить попытку запроса позже.

400 Bad Request

Запрос имеет неверный формат:

• В запросе отсутствуют обязательные заголовки.
• Тело запроса обязательно, но отсутствует.
• Тело запроса имеет неверный формат.
• Параметры тела запроса имеют недопустимые значения.
• Размер тела запроса не соответствует требованиям.

500 Internal Server Error

Произошла ошибка при обработке запроса

В теле ответа может содержаться описание ошибки.