# 设置登录配置
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
weDataSetLoginConfig
# 功能描述
设置服务商登录配置
# 注意事项
登录配置分为PC端和小程序端,根据接入方式不同需要配置相应的信息。
# PC端
PC端登录需配置反查地址用于查询用户访问服务商系统的登录态,因此服务商需要提供反查接口,详情可见 文档->3.接入流程->第3步->PC端->登录态反查
# 小程序端
- 小程序端登录需配置跟第三方平台账号的关联小程序,由关联小程序发起跳转请求,关联小程序个数上限为5个
- 注意这里的关联小程序是指服务商自己用来发起跳转we分析的小程序,不是指商家的小程序
- 配置完成后,第三方平台的小程序端可以通过调用“半屏小程序”的能力,将We分析小程序以半屏的形态跳转。详情可见 文档->3.接入流程->第3步->小程序端
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wedata/wedata_set_login_config?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用component_access_token |
set_type | number | 是 | 1: 配置反查地址 ; 2:配置关联appid |
recheck_url | string | 否 | 反查地址,set_type =1时生效,若为空表示删除 |
associate_appid | array<string> | 否 | 关联appid,set_type=2时生效,若为空表示删除 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 其他说明
# 登录态反查
描述:此接口由服务商自行提供,根据用户在服务商系统登录的登录态反查用户所属uid和过期时间
地址: ***(服务商提供http请求地址,但请求参数与返回参数需要遵循文档规定)
请求方法:POST application/json
请求参数:
参数名 | 类型 | 是否必须 | 备注 |
---|---|---|---|
user_session | string | 是 | 服务商session,用户访问服务商系统的session |
返回参数:
参数名 | 类型 | 是否必须 | 备注 |
---|---|---|---|
ret | number | 是 | 返回码 |
err_msg | string | 是 | 返回信息 |
uid | string | 是 | 用户在服务商系统的唯一标识,可以是手机号、邮箱、员工ID等等 |
expire_at | number | 是 | 过期时间(unix时间戳,单位秒) |
# 调用示例
示例说明: 配置反查地址
# 请求数据示例
{
"set_type": 1,
"recheck_url": "xxxxxxxxx"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "OK",
}
示例说明: 配置关联appid
# 请求数据示例
{
"set_type": 2,
"associate_appid": ["xxxxxxxxx"]
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "OK",
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
9900004 | 请求参数错误 | 请仔细检查请求参数格式 |