创建API Key并完成安全的首次读取

先用只读接口确认权限，再按当前OpenAPI接入目标产品；不要把商户接口与匿名演示混用。

打开操作页面

内容核对日期

操作页显示的当前可用性、报价和权限为准。文档日期不表示供应商实时可用；阅读帮助不会发起查询或付款。

开始前准备

  • 登录已验证的商户账号；在自己的服务器准备私有环境变量，不把Key写进浏览器前端或仓库。

按步骤操作

  1. 在“API Keys”填写名称，按实际用途选择只读或读写，创建并立即私有保存。密钥只显示一次；失去后撤销旧Key并新建，不向客服索回。

    你应该看到： 列表显示名称、前缀和权限；完整Key不长期展示。

  2. 使用下方只读示例读取 /console/api/capabilities。认证头是 Authorization: Bearer 加自己的Key，不是供应商Key。

    你应该看到： 返回本商户能力和限制；HTTP 200只证明读取成功，不代表所有真实产品已开通。

  3. 打开当前商户OpenAPI，查目标产品的Schema、权限、报价与幂等字段。每笔新任务用新编号，同一笔不确定请求保持编号及参数不变。

    你应该看到： 能指出该接口是沙盒还是真实业务，知道从哪里查询原结果。

read -rsp 'GridZen API Key: ' GRIDZEN_API_KEY; echo
export GRIDZEN_API_KEY
curl --fail-with-body https://gridzen.ai/console/api/capabilities \
  -H "Authorization: Bearer $GRIDZEN_API_KEY"
unset GRIDZEN_API_KEY

OpenAPI JSON

怎样算完成

只读请求成功，Key没有出现在源码、聊天或截图中；真实写入另按产品授权执行。

卡住了怎么办

  • 401：检查Key前缀、撤销／过期和Bearer格式。403：检查只读权限、产品准入和浏览器来源。429：遵守返回的限额，不换账号绕过。

下一步与相关说明

这一步不清楚？反馈具体位置

请写明：文章标题、卡在哪一步、页面显示什么、你期望看到什么。可附脱敏截图，不要附验证码、密钥、证件、完整账号或客户资料。

open@gridzen.ai