エラー
APIエラーの形式と、よくあるステータスの意味を整理します。
概要
エラー時はmessage と ctx_id を含むJSONが返ります。ctx_id はサポート問い合わせ時の重要な手掛かりになります。エラー形式
{
"message": "エラーメッセージ",
"ctx_id": "xxxxxxxx"
}
message: 問題の概要ctx_id: 問い合わせ時の参照ID（空の場合もあります）
ステータス別の対処
- 400: リクエスト内容の不足・形式エラー
- 401: 認証情報が無効／期限切れ
- 403: 権限不足（Regularトークンで書き込みをした等）
- 404: エンドポイントが見つからない
- 429: リクエスト過多（時間を空けて再試行）
- 500: サーバー側のエラー（
ctx_idを控えて問い合わせ）