概览与准备
金兔子开放平台对外提供的核心能力是:让用户用金兔子账号登录你的应用,并在用户明确同意的前提下获取其资料字段。协议是标准 OAuth 2.0 授权码模式,凭证是 client_id + client_secret。
接入前准备
- 注册开放平台账号(手机号 + 短信验证码),并绑定金兔子账号;
- 提交企业资质:营业执照名称、统一社会信用代码(18 位,带校验位)、法人信息、联系人与执照照片。仅支持企业与个体工商户;
- 资质通过后创建应用,选择接入平台(Android / iOS / Web / 小程序),填写包名、Bundle ID 与回调地址;
- 把平台签发的
client_id、client_secret配置到你的服务端(原生 App 请使用「公开客户端」,不携带密钥); - 充值后即可调用用户资料接口,费用按字段逐次扣减。
客户端类型怎么选
| 类型 | 适用 | 是否持有密钥 | PKCE |
|---|---|---|---|
| confidential 机密客户端 | 你有自己的服务端 | 是,密钥只放服务端 | 可选(建议开启) |
| public 公开客户端 | Android / iOS 原生 App | 否,只允许 client_id | 强制 |
端点一览
| 用途 | 方法与路径 |
|---|---|
| 授权页 | GET https://open.jintuzi.com/oauth/authorize |
| 换取令牌 | POST https://open.jintuzi.com/oauth/token |
| 获取用户资料 | GET https://open.jintuzi.com/oauth/userinfo |
| 撤销令牌 | POST https://open.jintuzi.com/oauth/revoke |
| 令牌内省 | POST https://open.jintuzi.com/oauth/introspect |
| 服务元数据 | GET https://open.jintuzi.com/.well-known/oauth-authorization-server |
安全红线
client_secret只在创建 / 重置时显示一次,请立刻存入密钥管理系统;- 回调地址必须逐字与后台登记的一致(精确匹配,不支持通配符);
- 授权码 5 分钟有效、单次可用,重复使用会失败;
- refresh_token 轮换使用,检测到重放会撤销整个令牌家族。