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

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

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

200 OK

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

201 Created

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

202 Partial success

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

401 Unauthorized user

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

Примеры:

• Запрос без заголовка 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

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

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