エラーコード
エラーコードは 2 層構成です。外側の code は API 層の結果を、data.bizCode は業務の結果を表します。code == 0 かつ data.bizCode == 0 の場合にのみ、呼び出しは成功です。統一レスポンス構造を参照してください。
API エラーコード（code）
| code | 説明 | 対処 |
|---|---|---|
| 0 | 成功 | — |
| 401 | 認証失敗 | 下表で具体的な原因を確認してください |
| 429 | Too Many Requests | 呼び出し頻度を下げて再試行してください。各 API の上限は 10 リクエスト / 秒です |
401 の原因
| メッセージ | 意味 | 対処 |
|---|---|---|
| Missing required headers | 必須のリクエストヘッダーが不足しています | 共通リクエストヘッダーがすべて含まれているか確認してください |
| Invalid timestamp format | タイムスタンプの形式が正しくありません | X-Timestamp は秒単位のタイムスタンプにしてください |
| Request timestamp expired | リクエストのタイムスタンプが期限切れです | サーバーの時刻を同期してから再送信してください |
| Invalid nonce format | nonce が形式ルールを満たしていません | ^[A-Za-z0-9]{16,32}$ に一致させてください |
| Nonce already used or validation failed | nonce が使用済み、または検証に失敗しました | リクエストごとに新しいランダム文字列を使用し、再利用しないでください |
| appId not found | appId が存在しません | APP-ID を確認してください |
| appId is disabled | appId が無効化されています | テクニカルサポートにお問い合わせください |
| Signature calculation failed | 署名の計算に失敗しました | 署名の実装を確認してください。署名メカニズムを参照 |
| Signature verification failed | 署名の検証に失敗しました | 署名対象文字列の連結順序、path に /open-apis プレフィックスが含まれているか、timestamp と nonce がヘッダーの値と一致しているかを確認してください |
業務エラーコード（bizCode）
| bizCode | 説明 |
|---|---|
| 0 | 成功 |
| 10000001 | パラメータが不正です |
| 10000003 | リクエストが多すぎます。しばらく待ってから再試行してください |
| 10000103 | システムサービスに異常が発生しました。カスタマーサービスにお問い合わせください |
| 100027001 | クレジット操作のパラメータが不正です |
| 100027003 | クレジット残高が不足しています |
| 100041003 | 空間モデリングタスクが存在しません |
| 100041004 | 空間モデリングの結果が見つかりません |
| 100041006 | 空間が見つかりません |
| 100041010 | AppId に空間モデリングの権限がありません |
| 100041016 | タスクのステータスが［モデリング中］のため、削除できません |
| 100041017 | 現在のステータスではタスクをキャンセルできません |
モデリング失敗時のトラブルシューティング
タスクがモデリング失敗（9）になった場合は、タスク一覧のページング取得またはタスク詳細を呼び出し、errorCode と failedReason で原因を確認してください。
この 2 つのフィールドはモデリングパイプライン内部の失敗情報を返すもので、上記の bizCode とは別の値体系です。API 呼び出しが成功してもタスクのモデリングが失敗した場合、bizCode は 0 のままです。