Skip to content

鉴权与 API Key ​

现在需要 Key 吗 ​

按数据库当前配置,全站接口的调用费用均为 0(免费),也没有接口开启「个人限流」。绝大多数接口直接拼路径就能调用,不需要先申请 Key。

Key 是给需要识别调用者身份的场景准备的:当某个接口被配置为付费接口或开启个人限流时,请求就必须带上有效 Key。

与参数表的关系

key 是全站通用的身份参数,不是接口的业务参数,因此不会出现在各接口的参数表里。站内详情页的调试面板单独提供了「API Key(可选)」输入框。

获取与重新生成 ​

  1. 登录本站账号,进入 用户中心。
  2. 找到「API Key 管理」,默认只显示首尾各 8 位,中间遮蔽。
  3. 点显示按钮查看完整值,或点复制按钮复制到剪贴板。
  4. 需要作废时点「重新生成 API Key」,确认后旧 Key 立即失效。

怎么传 ​

bash
curl "https://api.sco1.cn/Interface/GoldPrice/?symbol=XAU&key=YOUR_API_KEY"

在站内详情页调试时,把 Key 填进独立的「API Key(可选)」输入框即可。

相关错误码 ​

codemsg通常原因
401Invalid API keyKey 不存在、已重新生成、或复制时带了多余空格
402账号余额不足框架保留码,当前接口费用均为 0
403API key required接口要求 Key 但请求里没带

安全建议 ​

不要写进前端页面、公开仓库或聊天记录里。服务端调用放在环境变量里。怀疑泄露就立即在用户中心重新生成。

接口数据实时读取自站点数据库