身份验证

使用 Bearer API 密钥(dcs_live_ 和 dcs_test_)进行身份验证——创建、保存、轮换和撤销密钥——并了解它们在哪些地方可用。

对公共 API 的每次调用都需要在 Authorization 请求头中携带 API 密钥:

Authorization: Bearer dcs_live_9fK2mQ7xLp4Rt8Vw1Zc6Nb3Hy5Js0Ad2

密钥由 dcs_live_ 或 dcs_test_ 加上 32 个字母和数字组成。缺少请求头、使用 Bearer 以外的认证方案、密钥格式错误、未知或已撤销,都会以如下错误失败:

401 Unauthorized
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing, invalid or revoked API key.",
    "request_id": "req_Qm8vT2kLx9Pw4Rz7Nc1B"
  }
}

创建密钥

  1. 在应用中打开 API 密钥,点击新建密钥。
  2. 为它命名(例如将使用它的服务名称),并选择环境:Live(dcs_live_…)或 Test(dcs_test_…)。
  3. 点击创建密钥并复制。完整的密钥只显示一次。

把它保存在你的密钥管理器中,或作为环境变量(例如 DCISION_API_KEY)。Dcision 只保存密钥的 SHA-256 哈希值,因此丢失的密钥无法找回——请创建一个新的。

密钥列表显示每个密钥的名称、掩码形式(dcs_live_9fK2…0Ad2)、环境、创建时间和最近使用时间(最多每分钟更新一次)。Member、Admin 和 Owner 可以创建、重命名和撤销密钥;Viewer 只能查看列表——参见团队、角色与账户。一个工作区最多可以有 50 个有效密钥。

Live 密钥和 Test 密钥

两种环境的行为完全相同:它们调用相同的已部署版本,共享工作区的速率限制,计费方式也相同。区别在于组织管理——把 test 密钥用于预发布环境、CI 和本地开发,这样撤销它们时不会影响生产环境——外加一个标记:使用 test 密钥发起的调用,其目的地投递会带有 livemode: false,接收方可以据此把它们排除在生产环境之外。

作用范围

  • 一个密钥属于一个工作区,可以调用该工作区的所有决策,并通过 GET /v1/decisions、GET /v1/me 和 GET /v1/executions 读取其决策、账户和执行记录。同一个密钥也用于 MCP 服务器的身份验证。
  • 来自其他工作区的密钥无法访问你的决策:它会得到 404 DECISION_NOT_FOUND,其 /v1/executions 也只会列出它自己工作区的运行。
  • 密钥只能用于公共 API(/v1/…)。应用的端点会以 403 FORBIDDEN 拒绝它们——“API keys can only call the /v1 decision endpoints.”

验证密钥

GET /v1/me 会返回 200 及密钥所属的工作区、名称、环境和套餐,或返回 401 INVALID_API_KEY。这是适合 CI 和部署脚本的低成本检查——它不会运行决策,也不计费:

curl -sf https://api.dcision.io/v1/me -H "Authorization: Bearer $DCISION_API_KEY" > /dev/null \
  && echo "key OK" || echo "key rejected"

轮换密钥

  1. 创建一个新密钥。
  2. 使用新密钥部署你的应用。
  3. 当旧密钥的最近使用不再变化时,撤销旧密钥。

撤销密钥

撤销立即生效且无法撤回:所有使用该密钥的请求都会以 401 INVALID_API_KEY 失败。已撤销的密钥会以灰色保留在列表中,供参考。

保护好密钥

  • 从你的服务器调用 API,切勿从浏览器、移动应用或客户端打包代码中调用。
  • 切勿把密钥提交到代码仓库;从环境变量中加载。
  • 每个服务使用一个密钥,这样撤销其中一个不会影响其他服务。

本页内容