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 在产生流量和费用。status、expires_at、revoked_at一起决定这把 key 当前是否还能用。
为什么没有完整 key
完整 key 只会在创建时返回一次。列表接口用于查看状态和使用情况,不用于找回密钥。