# 用户PC端登录

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

wedata_login

# 功能描述

用户PC端登录

# 注意事项

登录前需要先给调用设置权限接口给用户设置权限
登录前服务商需先使用设置登录配置接口设置反查地址

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wedata/wedata_login?access_token=ACCESS_TOKEN

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：18
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用authorizer_access_token
user_session	string	是	服务商session，用户访问服务商系统的session
uid	string	是	用户在服务商系统的唯一标识，可以是手机号、邮箱、员工ID等等
client_ip	string	是	用户的外网ip
user_agent	string	是	用户的user_agent

# 返回参数

属性

类型

说明

base_resp

object

返回信息

	属性	类型	说明
	ret	number	返回码
	err_msg	string	返回信息

redirect_url

string

We分析登录链接

expire_at

number

过期时间（unix时间戳，单位秒）

# 其他说明

# 特殊错误码

访问获取到的登录链接, 若出现100024错误码，表示此时we分析系统获取到的用户client_ip和user_agent 跟服务商系统调用api时传入的不一致

# 登录态反查

描述：此接口由服务商自行提供，在调用登录接口时会根据用户在服务商系统登录的登录态反查用户所属uid和过期时间
地址： ***（服务商提供http请求地址，但请求参数与返回参数需要遵循文档规定）
请求方法：POST application/json
请求参数：

参数名	类型	是否必须	备注
user_session	string	是	服务商session，用户访问服务商系统的session

返回参数：

参数名	类型	是否必须	备注
ret	number	是	返回码
err_msg	string	是	返回信息
uid	string	是	用户在服务商系统的唯一标识，可以是手机号、邮箱、员工ID等等
expire_at	number	是	过期时间（unix时间戳，单位秒）

# 调用示例

示例说明: HTTPS请求示例

# 请求数据示例


{
	"user_session": "session_key",
	"uid": "test",
	"client_ip": "127.0.0.1",
	"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36"
}

# 返回数据示例


{
	"base_resp": {
		"ret": 0,
		"err_msg": "OK"
	},
	"redirect_url": "https://wedata.weixin.qq.com/mp2/supplier/login?open_login=1&open_sid=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"expire_at": 1663818592
}

# 错误码

错误码	错误码取值	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
9900004	请求参数错误	请仔细检查请求参数格式
9900016	无权限操作	1. 权限相关操作时检查商家we分析权限管理员是否关闭了服务商的成员管理权限

设置权限操作时检查商家账号的权限集列表是否包含请求参数中的权限集 3.登录时uid是否有设置权限 | | 9900018 | 非法session | 请检查session是否正确 | | 9900019 | session已过期 | 重新生成session |