Коды ошибок
У каждой ошибки есть постоянный код. SDK используют те же коды (в Unity — в виде enum) и ещё несколько собственных для проблем, которые возникают до того, как запрос дошёл до сервера.
Комментарии в коде и имена API оставлены на английском, чтобы совпадать с SDK.
На этой странице
Ошибки API#
| Код | HTTP | Unity | Когда возникает | Повторять? |
|---|---|---|---|---|
validation | 400, 422 | Validation | Некорректные входные данные; поле указано в details.fields. | Нет |
unauthorized | 401 | Unauthorized | Неверные ключи либо отсутствующий, истёкший или отозванный токен игрока. | Нет |
forbidden | 403 | Forbidden | Проект приостановлен, эндпоинт доступен только серверу или требуется HTTPS. | Нет |
plan_limit | 403 | PlanLimit | Достигнут лимит тарифа (игроки, записи, хранилище…). Ничего не удаляется. | Нет |
not_found | 404 | NotFound | Неизвестный эндпоинт, таблица лидеров, игрок или ключ сохранения. | Нет |
conflict | 409 | Conflict | Действие уже выполнено, например награда уже получена в этом периоде. | Нет |
revision_mismatch | 409 | RevisionMismatch | Облачное сохранение изменилось на другом устройстве. | Нет |
rate_limited | 429 | RateLimited | Слишком много запросов в минуту или действует пауза таблицы лидеров. Подождите Retry-After секунд. | Да |
quota_exceeded | 429 | QuotaExceeded | Дневная квота запросов аккаунта исчерпана; она обновляется в 00:00 UTC. | Нет |
server_error | 500 | ServerError | Сбой на сервере. Безопасные запросы SDK повторяют автоматически. | Да |
Ошибки на стороне SDK#
| Код | HTTP | Unity | Когда возникает | Повторять? |
|---|---|---|---|---|
network | — | Network | Не удалось связаться с сервером. | Да |
timeout | — | Timeout | Запрос выполнялся дольше, чем позволяет тайм-аут. | Да |
not_configured | — | NotConfigured | Базовый URL, ID проекта или клиентский ключ не указаны или некорректны. | Нет |
not_signed_in | — | NotSignedIn | Вызов от имени игрока до входа или после истечения сессии. | Нет |
signature_invalid | — | SignatureInvalid | Удалённая конфигурация не прошла проверку и не была применена. | Нет |
parse_error | — | ParseError | Не удалось прочитать ответ (обычно из-за прокси или HTML-страницы с ошибкой). | Нет |
link_expired | — | LinkExpired | Срок действия страницы привязки аккаунта истёк; начните заново. | Нет |
link_cancelled | — | LinkCancelled | Привязка аккаунта отменена. | Нет |
Обработка ошибок#
Показывайте message разработчикам, а не игрокам; ветвите логику по коду. Повторяйте только ошибки, допускающие повтор, и записывайте ID запроса в лог, чтобы найти запрос на странице «Логи».
var top = await Majacloud.Leaderboards.GetTopAsync("coins", 10);
if (top.Ok)
{
foreach (var entry in top.Value.Entries)
Debug.Log($"#{entry.Rank} {entry.PlayerName} {entry.Score}");
}
else if (top.Error.IsRetryable)
{
// Network, timeout, 5xx or rate limit: try again later
Debug.Log("Retry in " + top.Error.RetryAfterSeconds + " s");
}
else
{
Debug.LogWarning(top.Error.Code + ": " + top.Error.Message + " (" + top.Error.RequestId + ")");
}var top := await Majacloud.leaderboards.get_top("coins", 10)
if top.ok:
for entry in top.value.entries:
print("#%d %s %d" % [entry.rank, entry.player_name, entry.score])
elif top.is_retryable():
# Network, timeout, 5xx or rate limit: try again later
print("Retry in ", top.retry_after, " s")
else:
push_warning("%s: %s (%s)" % [top.error, top.message, top.request_id])const top = await mc.leaderboards.getTop('coins', { limit: 10 });
if (top.ok) {
for (const entry of top.value.entries) {
console.log(`#${entry.rank} ${entry.player_name} ${entry.score}`);
}
} else if (top.error.retryable) {
// Network, timeout, 5xx or rate limit: try again later
console.log('Retry in', top.error.retryAfter, 's');
} else {
console.warn(`${top.error.code}: ${top.error.message} (${top.error.requestId})`);
}// Success
{ "ok": true, "entries": [ … ], "total": 42 }
// Error (HTTP 4xx/5xx)
{
"ok": false,
"error": {
"code": "rate_limited",
"message": "Project rate limit reached. Try again in a minute.",
"request_id": "6f1c2a9e-…",
"details": { "limit": 120, "window": "minute" }
}
}