Ошибки

Раздел содержит описание наиболее вероятных ошибок, возникающих при работе с API платформы. Здесь представлены коды ошибок, их причины, а также возможные действия для их устранения. Это поможет вам быстрее идентифицировать и исправлять проблемы.

Все ошибки разделены на две основные категории:

• Клиентские ошибки — вызваны неверными данными или некорректным использованием API.
• Серверные ошибки — возникают из-за неполадок на серверной стороне.

Примеры ошибок

Примеры типичных ошибок и как они выглядят в формате ответа:

400: Неверный запрос

1{
2  "status": "error",
3  "error": {
4    "title": "Invalid Request",
5    "text": "Field 'name' cannot be empty. Field 'url' is invalid.",
6  },
7  "fields": [{
8      "name": "name",
9      "message": "This field is required.",
10    },
11    {
12      "name": "url",
13      "message": "Invalid URL format.",
14    },
15  ],
16
17}

Причина: Отправлены некорректные данные. Например, пустое поле или неправильный формат.
Решение: Проверьте обязательные параметры в body запроса и корректность переданных данных.

401: Неавторизованный доступ

1{
2  "status": "error",
3  "error": {
4    "title": "Unauthorized",
5    "text": "You need to provide a valid token to access this resource."
6  }
7}

Причина: Отсутствие или неправильный токен авторизации.
Решение: Убедитесь, что токен передается в заголовке Authorization и он действителен.

403: Доступ запрещен

1{
2  "status": "expired",
3  "error": {
4    "title": "Ошибка",
5    "text": "expired"
6  }
7}

Причина: У пользователя нет прав для выполнения указанного действия.
Решение: Проверьте роли и права доступа в системе.

404: Ресурс не найден

1{
2  "status": "error",
3  "error": {
4    "title": "Not Found",
5    "text": "The requested resource does not exist."
6  }
7}

Причина: Указанный ресурс отсутствует в системе.
Решение: Проверьте корректность URL или идентификатора ресурса.

500: Внутренняя ошибка сервера

1{
2  "status": "error",
3  "error": {
4    "title": "Internal Server Error",
5    "text": "Something went wrong. Please try again later."
6  }
7}

Причина: Проблема на стороне сервера.
Решение: Свяжитесь с технической поддержкой и предоставьте подробности запроса.