API Key 列表导读

这页展示的是 key 的状态和使用情况,不会返回完整密钥。

GET/v1/customer/api-keys

请求示例

bash
curl "https://api.therouter.ai/v1/customer/api-keys" \
  -H "Authorization: Bearer $THEROUTER_API_KEY"

返回字段怎么看

json
{
  "api_keys": [
    {
      "id": "4d953cc1-b4d5-45fd-9d51-0f0a6e2ec7d8",
      "name": "backend-prod",
      "key_preview": "a8c9X2zQ",
      "expires_at": null,
      "is_active": true,
      "revoked_at": null,
      "last_used_at": "2026-02-24T11:08:00.000Z",
      "status": "active",
      "usage": {
        "request_count": 241,
        "total_spend": 12.441
      },
      "created_at": "2026-02-20T08:30:00.000Z"
    }
  ],
  "total": 1
}
  • key_preview 只用于确认是哪把 key,不可用于重新调用接口。
  • usage 帮你快速判断哪把 key 在产生流量和费用。
  • statusexpires_atrevoked_at 一起决定这把 key 当前是否还能用。
为什么没有完整 key
完整 key 只会在创建时返回一次。列表接口用于查看状态和使用情况,不用于找回密钥。

下一步