開發者文件

把年鑑資料接入
你的研究工作流程

透過穩定的 HTTP API 查詢長期指標、年鑑版本與完整二維表格,並保留統計口徑、資料版本和官方來源。

建立 API 金鑰查看 API 參考
密钥与鉴权

让密钥只出现在可信环境

每次请求都通过 HTTP Authorization 请求头传递 Bearer 密钥。密钥代表账户的数据权限,请像密码一样保存。

创建

在个人中心创建密钥

  1. 登录专业会员或管理员账户。
  2. 打开数据与 API,为密钥填写用途名称。
  3. 创建后立即复制并保存;完整密钥离开页面后不会再次显示。
请求头

使用 Bearer 鉴权

Authorization: Bearer sdo_你的完整密钥

密钥前缀固定为 sdo_。不要放在查询参数、URL、Cookie 或请求正文中。

推荐

保存在服务器密钥管理服务、CI Secret 或本机环境变量。

避免

不要提交到 Git,不要在客户端 JavaScript、截图或工单中公开。

轮换

为不同程序创建不同密钥。停止使用后立即撤销,再创建新密钥。

排查

出现 401 时检查完整密钥、Bearer 格式和密钥是否已经撤销。