账号与控制台

NumCat 现在支持独立账号体系。登录态用于进入控制台、管理 API Key、查看套餐和调用量；实际数据接口仍然继续使用apikey调用。

查看价格页打开控制台

能力边界

1. Web 登录态和数据接口鉴权是两层能力。

2. 登录成功后，可以在控制台创建、轮换、吊销自己的 API Key。

3. 调用数据接口时，仍然使用请求体里的 apikey。

4. 套餐、调用量和 API Key 归属，都绑定在 NumCat 自己的账号体系里。

登录请求

浏览器侧通过 BFF 调用POST /api/auth/login，成功后会写入 HttpOnly Cookie。

{
  "phone": "13800138000",
  "password": "abc123456"
}

注册请求

注册前先调用POST /api/auth/send-code获取验证码，再提交注册。

{
  "username": "numcat-dev",
  "phone": "13800138000",
  "password": "abc123456",
  "verify_code": "123456"
}

控制台接口

路径

方法

说明

/api/auth/profile

GET

获取当前登录用户和套餐信息

/api/me/api-keys

GET

获取当前用户的 API Key 列表

/api/me/api-keys

POST

创建新的 API Key

/api/me/api-keys/{id}/rotate

POST

轮换 API Key

/api/me/api-keys/{id}

DELETE

吊销 API Key

/api/me/subscription

GET

获取当前套餐状态

创建 API Key 响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "id": 3,
    "name": "默认密钥",
    "raw_key": "nc_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "active",
    "scopes": "*",
    "expires_at": null,
    "created_at": "2026-03-22T15:28:44+00:00"
  }
}

raw_key只会在创建或轮换时返回一次，控制台展示后应立即保存。