# エンジンの状態

`GET https://api.dataforgeo.dev/v1/status` · public, no auth

各エンジンの現在の状態、直近 24 時間の成功率と中央値レイテンシ、直近 30 日の日別可用率を返します。認証不要・無料なので、リクエスト前に使えるエンジンを確認できます。公式サイトのステータスページも同じデータを使っています。

### リクエスト例

```bash
curl "https://api.dataforgeo.dev/v1/status"
```

### レスポンス例

```json
{
  "updated_at": "2026-11-02T05:40:00Z",
  "status": "degraded",
  "engines": [
    {
      "id": "chatgpt",
      "name": "ChatGPT",
      "answer_type": "product",
      "status": "operational",
      "last_24h": {
        "success_rate": 0.987,
        "median_latency_ms": 21400,
        "calls": 1234
      },
      "daily": [
        {
          "date": "2026-10-04",
          "uptime": 0.998
        },
        "… 30 项 …",
        {
          "date": "2026-11-02",
          "uptime": 1
        }
      ]
    },
    {
      "id": "claude",
      "name": "Claude",
      "answer_type": "model",
      "status": "degraded",
      "last_24h": {
        "success_rate": 0.912,
        "median_latency_ms": 9800,
        "calls": 640
      },
      "daily": [
        "…"
      ]
    },
    {
      "id": "grok",
      "name": "Grok",
      "answer_type": "model",
      "status": "unavailable",
      "last_24h": {
        "success_rate": 0.64,
        "median_latency_ms": 7300,
        "calls": 210
      },
      "daily": [
        "…"
      ]
    },
    "…"
  ]
}
```

### engines[].status の値

| status | 意味 |
| --- | --- |
| `operational` | 正常 |
| `degraded` | 低下：直近 15 分間の成功率が 90% 未満。リクエストは送られますが失敗が増える可能性があります |
| `unavailable` | 利用不可：このエンジンの回答は failed / engine_unavailable で返り、課金されません |

- トップレベルの status は全エンジンの集約です。すべて unavailable なら outage、いずれかが degraded か unavailable なら degraded、それ以外は operational。
- last_24h は直近 24 時間の実呼び出しを集計します。success_rate は 0〜1 の小数、median_latency_ms は中央値レイテンシ、calls は呼び出し回数。呼び出しがなければ前の 2 つは null。google-aio の no_answer は成功扱い、キャッシュヒットは含みません。
- daily は UTC 日付で常に 30 件、古い順で最後が今日です。呼び出しがない日の uptime は null。
- 認証不要・CORS *・レスポンスは 30 秒キャッシュ。データは 5 分ごとに集計されます。Web 版は dataforgeo.dev/status。