代理第三方平台代注册/免登流程

免登接口地址

GET https://www.jisuapp.cn/index.php/Oauth2/AgentAuthLogin

请求参数

参数 类型 必填 说明
timestamp String Y 当前时间的时间戳
uid String Y 第三方平台用户的身份 id
client_id String Y 第三方平台在即速云商家应用注册的 client_id
username String Y 第三方平台用户的用户名
sign String Y 请求签名,用于校验
redirect_host String N 免登跳转域名

请求参数说明

sign 参数

是按固定顺序将
timestamp
uid
client_id
client_secret(第三方平台在即速云商家应用注册的 client_secret)
这几个字符串连接后直接用 md5 算出的签名。

例如 timestamp=1610010351 uid=608599 client_id=DdjFx24 client_secret=ideiIjfexvv8121

sign 就是通过 md5("1610010351608599DdjFx24ideiIjfexvv8121") 算出的,sign 的有效期是 5 分钟

redirect_host 参数

如果想在 iframe 中进行免登,需要免登链接的域名和第三方主页面的域名是同域的才可以成功。
第三方可以自行将某个子域名(如 api.abc.com)进行服务器代理转发配置,将子域名请求全部转到 https://www.jisuapp.cn
然后传这个子域名参数(api.abc.com)过来,得到的免登链接中会将 www.jisuapp.cn 域名替换成传过来的 api.abc.com

返回参数

正常结果:

{
    "status": 0, // status 为 0
     // 即客云的页面链接,可让前端进行跳转或嵌入
     // 如果传了 redirect_host 参数,www.jisuapp.cn 会被替换成 redirect_host 的域名
    "data": "https://www.jisuapp.cn/index.php/Oauth2/AgentAuthLoginRedirect?sign=1e9d44b9b1a7dc87a55ff905e2d616d6d7PymP"
}

异常结果:

{
    "status": 1,               // status 为 1
    "data": "请求过期,请重试"  // data 为具体的报错信息
}

代注册后推送新用户信息

在用户第一次免登时,会代用户在即速平台注册并开通商家应用,在注册完成后,会将新用户的信息推送给第三方平台,需要第三方平台提供接收新用户信息的接口(如 https://abc.com/user/notify) 并保存好 uid 和 client_id/client_secret/app_id 的关系,后续调用即速云商家应用接口时需要自行使用对应用户的 client_id 和 client_secret 进行授权。

推送方式 POST,推送内容如下:

字段 说明
timestamp 当前时间的时间戳
uid 第三方平台的用户身份 id
client_id 新用户的即速云商家应用 client_id
client_secret 新用户的即速云商家应用 client_secret
app_id 新用户在即速平台创建的小程序 id
sign 请求签名,用于校验

请求参数说明

sign 参数

是按固定顺序将
timestamp
uid
client_id
client_secret(第三方平台在即速云商家应用注册的 client_secret,不是新用户的 client_secret)

这几个字符串连接后直接用 md5 算出的签名,接收方可通过该签名进行请求校验

results matching ""

    No results matching ""