主题
鉴权与 API Key
现在需要 Key 吗
按数据库当前配置,全站接口的调用费用均为 0(免费),也没有接口开启「个人限流」。绝大多数接口直接拼路径就能调用,不需要先申请 Key。
Key 是给需要识别调用者身份的场景准备的:当某个接口被配置为付费接口或开启个人限流时,请求就必须带上有效 Key。
与参数表的关系
key 是全站通用的身份参数,不是接口的业务参数,因此不会出现在各接口的参数表里。站内详情页的调试面板单独提供了「API Key(可选)」输入框。
获取与重新生成
- 登录本站账号,进入 用户中心。
- 找到「API Key 管理」,默认只显示首尾各 8 位,中间遮蔽。
- 点显示按钮查看完整值,或点复制按钮复制到剪贴板。
- 需要作废时点「重新生成 API Key」,确认后旧 Key 立即失效。
怎么传
bash
curl "https://api.sco1.cn/Interface/GoldPrice/?symbol=XAU&key=YOUR_API_KEY"在站内详情页调试时,把 Key 填进独立的「API Key(可选)」输入框即可。
相关错误码
| code | msg | 通常原因 |
|---|---|---|
| 401 | Invalid API key | Key 不存在、已重新生成、或复制时带了多余空格 |
| 402 | 账号余额不足 | 框架保留码,当前接口费用均为 0 |
| 403 | API key required | 接口要求 Key 但请求里没带 |
安全建议
不要写进前端页面、公开仓库或聊天记录里。服务端调用放在环境变量里。怀疑泄露就立即在用户中心重新生成。