概览与准备

金兔子开放平台对外提供的核心能力是:让用户用金兔子账号登录你的应用,并在用户明确同意的前提下获取其资料字段。协议是标准 OAuth 2.0 授权码模式,凭证是 client_id + client_secret。

接入前准备

  1. 注册开放平台账号(手机号 + 短信验证码),并绑定金兔子账号;
  2. 提交企业资质:营业执照名称、统一社会信用代码(18 位,带校验位)、法人信息、联系人与执照照片。仅支持企业与个体工商户;
  3. 资质通过后创建应用,选择接入平台(Android / iOS / Web / 小程序),填写包名、Bundle ID 与回调地址;
  4. 把平台签发的 client_id、client_secret 配置到你的服务端(原生 App 请使用「公开客户端」,不携带密钥);
  5. 充值后即可调用用户资料接口,费用按字段逐次扣减。

客户端类型怎么选

类型适用是否持有密钥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 轮换使用,检测到重放会撤销整个令牌家族。