开发指南

接口文档


设置商户配置(一个商户clientId只有一个配置)


备注:client id创建流程:http://yun.weimob.com/doc/article?tag=ab

接口定位与使用场景

· 在商户使用H5通用免登前,需要商户进行初始化设置

· 根据设置的不同,主要分为两种: 1.通用设置 2.场景设置

通用设置:用户数量级,过期时间等

场景设置:登录回调等

请求地址:https://dopen.weimob.com/api/1_0/janus/config/setConfig?accesstoken=ACCESS_TOKEN

请求方式: HTTP.POST

请求入参

参数名

必选

类型

长度

说明

loginCallbackUrl

200

Long

登录回调

numberScale

Long

20

用户数量级(默认值1000000)

expires

Long

20

过期时间(s)(默认值1296000s 15天)

 

{ "loginCallbackUrl":"loginCallbackUrl", "numberScale":"1000000", "expires":1296000 }


请求出参

参数名

类型

说明

data

Boolean

true表示设置成功

 

{ "code": { "errcode": "0", "errmsg": "成功" }, "data": true }


备注

· 更多返回错误代码请看错误码页面


查看商户配置


接口定位与使用场景

· 用于查看商户配置

请求地址:https://dopen.weimob.com/api/1_0/janus/config/getConfig?accesstoken=ACCESS_TOKEN

请求方式: HTTP.POST

请求入参

请求出参

参数名

类型

说明

loginCallbackUrl

String

登录回调 (长度限制128)

numberScale

Long

数量级(默认值1000000)

expires

Long

过期时间(s)(默认值1296000s 15天)

 

{ "code": { "errcode": "0", "errmsg": "成功" }, "data": { "loginCallbackUrl": "loginCallbackUrl", "numberScale": 1000000, "expires": 1296000 } }


备注

· 更多返回错误代码请看错误码页面


登录接口(注册wid修改为 微盟用户获取登录票据)


接口定位与使用场景


· 用户点击微盟平台应用时,商户需要使用当前的用户openUserId登录,并将返回值的appTicket拼接到微盟前端参数

· 登录接口需要商户严格验证当前用户的登录状态

· 使用登录接口后,会自动注册微盟用户

· 商户pid+appClientId+openUserId与微盟用户唯一对应

请求地址:https://dopen.weimob.com/api/1_0/janus/core/login?accesstoken=ACCESS_TOKEN

请求方式: HTTP.POST

请求入参

参数名

必选

类型

长度

说明

openUserId

String

50

用户在第三方身份标识ID

nickname

String

50

用户名

headurl

String

200

头像地址

telephone

String

20

联系方式,注意格式11位数字

 

{ "openUserId": "157862", "nickname":"注册用户", "headurl":"", "telephone":"13895687417" }

请求出参

参数名

类型

说明

appTicket

String

一次性认证票据,有效时间5分钟

expires

Long

使用appTicket 登录之后的有效时间(秒),与配置中的有效时间一致

 

{ "code": { "errcode": "0", "errmsg": "成功" }, "data": { "appTicket": "6655521ab0ed456ab07ab8ad3683a07b", "expires": 864000 } }

备注

· 登录接口的中的用户信息,会作为当前用户信息展示给前端。

· 手机号仅作为展示信息,不作为微盟身份标识,即无法通过手机号+验证码的方式登录。

· 如果需要手机号做为身份认证,需要额外绑定openUserId和手机号。

· 更多返回错误代码请看错误码页面


登出接口


接口定位与使用场景


· 用户登出

· 切换账号

· 商户后台注销用户在线状态等

请求地址:https://dopen.weimob.com/api/1_0/janus/core/logout?accesstoken=ACCESS_TOKEN

请求方式: HTTP.POST

请求入参

参数名

必选

类型

说明

openUserId

String

用户在第三方身份标识ID

 

{ "openUserId":"157862", }

请求出参

参数名

类型

说明

data

Boolean

true表示设置成功

 

{ "code": { "errcode": "0", "errmsg": "成功" }, "data": true }

备注

· 登出时,如果用户在多端同时使用免登服务登录,都会被登出。

· 更多返回错误代码请看错误码页面


安全校验


使用场景


· 当会员登录状态过期或失效后,会主动访问配置中的回调地址。

格式:loginCallbackUrl?nonceStr=nonceStr×tamp=timestamp&redirectUrl=redirectUrl&sign=sign。

· 为保障回调请求的合法性,首先需要校验签名。其次,对于redirect_uri中的域名进行校验。

· 校验通过,可以根据当前用户实际登录状态去发起登录或者直接调用登录接口获取appTicket。

· appTicket+appClientId拼接到redirectUrl并跳转。

格式redirectUrl?appTicket=appTicket&appClientId=appClientId

签名校验

· url中sign去除,拼接开放平台token。示例:&token=accessToken

· sign = MD5(nonceStr=nonceStr×tamp=timestamp&redirectUrl=redirectUrl&token=accessToken)

域名校验

· 校验redirectUrl中域名为"weimob.com"结尾


通用错误码



错误码

错误码说明

枚举 (JanusErrorCodeEnum)

0

成功

SUCCESS

-1

系统错误

ERROR

 

接口错误码


错误码

错误码说明

枚举 (JanusErrorCodeEnum)

80011000000001

参数无效

INVALID_PARAMS

80011000000002

服务错误

SERVER_ERROR

80011002000101

登录失败

LOGIN_FAIL

80011002000102

授权成为微盟用户失败

GET_WID_FAIL

80011003000101

未设置登录回调

INVALID_CALLBACK

80011003000102

获取开放平台授权信息,请重试

GET_TOKEN_FAIL

 

售前咨询热线

10105188

在线QQ咨询

关注微盟

扫描关注官方微信

总部咨询热线:10105188 QQ:4006305400 邮箱:feedback@weimob.com 举报电话:02180356016

地址:上海市宝山区长江路258号微盟大厦

Copyright © 2011-2019 yun.weimob.com. All Rights Reserved 上海微盟企业发展有限公司版权所有 沪ICP备14044897号-9