Статусы ответов
22 августа 2024
ID 198539
В этом разделе описываются статусы ответов 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
Произошла ошибка при обработке запроса
В теле ответа может содержаться описание ошибки.