エラー

すべてのエラーは、安定した code つきの Problem Details です。エラーの区別にはコードを使い、変わることのある detail の文章は使わないでください。SDK はこれらを次の例外にします（Java と .NET：…Exception、TypeScript と Python：…Error）：

SDK の例外	コード
TenonAuthUnavailable（reason）	接続できない（UNREACHABLE）、時間内に応答がない（TIMEOUT）、5xx のサーバーエラー（SERVER_ERROR）。フェイルクローズしてください
ApiKeyRejected	unauthorized（401）
Forbidden	forbidden（403）
InvalidRequest（fields）	invalid_request とほかの 400
NotFound	not_found（404）
InvalidCode	invalid_code（422）
FactorLocked（lockedUntil）	factor_locked（429）
TooManyRequests（retryAfter）	too_many_requests（429）
EmailRefused	email_codes_not_allowed、email_domain_not_allowed、invalid_email、email_required
EmailUnavailable（challengeId）	email_unavailable（503）
Conflict（code）	ほかの 409
TenonAuth	それ以外（例：push_not_configured）

すべてのコード

コード	ステータス	意味
invalid_request	400	リクエストの形式やフィールドが正しくない。errors にフィールドの一覧
invalid_email	400	メールアドレスではない
email_required	400	メールのコードにはメールアドレスが必要
invalid_ip_address	400	ログインの情報の IP アドレスが IPv4 でも IPv6 でもない
invalid_username	400	（管理コンソールの管理者）ユーザー名はメールアドレスにする
invalid_display_name	400	（管理コンソールの管理者）名前は1〜100文字
unauthorized	401	有効な資格情報がない：API キーがない、違う、または無効にされた
forbidden	403	資格情報は有効だが、このアドレスには使えない
ip_not_allowed	403	（Tenon IT のプラットフォームキー）このアドレスからは使えない
not_found	404	組織にそのユーザー、方法、ログインの要求がない
method_not_allowed	405	このアドレスはその HTTP メソッドを受け付けない
request_too_large	413	リクエストの本文が 64 KB を超えている
wrong_factor_type	409	この方法ではできない（例：ログイン承認にコード）
factor_not_pending	409	その方法はすでに有効か、削除された
factor_not_active	409	その方法は有効ではない（未設定、または削除）
enrollment_expired	409	設定に時間がかかりすぎたか、コードを間違えすぎた。設定からやり直す
challenge_not_pending	409	ログインの要求はすでに承認、拒否、失敗、または期限切れ
challenge_not_approved	409	ログインの要求が承認されていない
challenge_too_old	409	承認からの時間が長すぎて、デバイスを記憶できない
challenge_already_used	409	このログインで、すでにデバイスを記憶した
no_active_factor	409	ユーザーに有効な方法がないので、復旧するものがない
email_codes_not_allowed	409	組織の管理者がメールのコードを許可していない
email_domain_not_allowed	409	そのアドレスのドメインは組織で許可されていない
organization_exists	409	（Tenon IT）同じ名前の組織がある
organization_claimed	409	（Tenon IT）組織の管理者がすでにログインした
username_taken	409	（管理コンソールの管理者）そのアドレスはすでに管理者のもの
platform_key_exists	409	（Tenon IT）同じ名前のプラットフォームキーがある
invalid_code	422	方法の設定中に入力したコードが違う
factor_locked	429	間違いが多すぎるため、その方法は lockedUntil までロック
too_many_requests	429	短時間に要求やメールが多すぎる。retryAfter 以降にもう一度
push_not_configured	503	このサーバーではログイン承認が設定されていない
email_unavailable	503	メールを送れなかった。ログイン時は、challengeId がリカバリーコード用にまだ開いている

ログイン時にコードを間違えても、エラーにはなりません。verify が verified: false と attemptsRemaining を返します。