# 非同期ジョブとアカウント

複数エンジン・複数サンプルのリクエストは 1〜2 分かかることがあります。async: true を指定すると job_id が即時に返り、ポーリングか webhook で結果を取得できます。同期リクエストは 120 秒を超えると自動で非同期になり 202 を返します。

### エンドポイント

| エンドポイント | 説明 | credits |
| --- | --- | --- |
| `GET /v1/jobs/{job_id}` | ジョブの状態と結果 | 0 |
| `GET /v1/account` | 残高・プラン・今月の利用量 | 0 |

### 非同期レスポンス

```json
{
  "job_id": "job_3b7e90",
  "status": "queued",
  "credits_held": 9
}
```

`GET /v1/account`

```json
{
  "plan": "scale",
  "credits_remaining": 10422,
  "credits_used_this_month": 1578
}
```

- status は queued → running → completed または failed。completed 時の result は同期レスポンスと同じです。
- 非同期リクエストでは timeout・failed の回答を約 2 分後にもう 1 度実行し、それでも失敗した場合に確定します。同期リクエストでは再実行しません。
- credits_held は仮押さえ分。実際に返った回答で精算し、余りは返却されます。
- webhook_url を指定すると完了時に全結果を POST します。x-dataforgeo-signature ヘッダー（HMAC-SHA256、鍵はコンソール）で送信元を検証できます。
- ジョブ結果は 7 日間保持されます。