单点登录
单点登录
提供标准单点登录接口。员工在企业办公系统门户上登录后,通过该接口跳转到华为云数字化差旅时可实现免登录预定操作。消息流程如下:
接口URL
生产环境: https://openapi.hwht.com/v3/urllogin
测试环境: https://openapi-uat.hwht.com/v3/urllogin
H5生产环境: https://m-itravel.hwht.com/openapi/v3/urllogin
H5测试环境: https://m-itravel-uat.hwht.com/openapi/v3/urllogin
以GET请方式调用。对应HttpBody作为encrypt参数加密传递,具体参数如下:
输入参数
参数名 | 参数说明 | 必选 | 参数类型 | 长度 | 值举例 | 备注 |
---|---|---|---|---|---|---|
CorpCode | 企业账号 | Y | String | 1000 | 系统提供的对接企业账号 | |
LoginName | 操作人帐号 | Y | String | HW_000001 | 系统的会员标识。格式:“企业拼音缩写_工号” 企业拼音缩写可能重复,需提前协商确定。 | |
EnterpriseTrID | 企业客户系统的审批单编号 | N | String | TA0315012116281300028 | 客户审批系统的审批单号。传空时根据TravelType跳转至因公因私。 | |
Lang | 语种 | N | String | CN:中文(默认)EN:英文 | **目前对外仅提供中文版。**该字段不提供则默认跳转到中文页面 | |
ServiceType | 业务类型 | N | String | 1:首页2:机票预订3:酒店预订4:个人中心5:订单中心6:国际机票预订7:国际酒店预订8:国内火车票预订9:离店确认10: 订单详情car_booking: 用车预订tmc: 差标管理 | 传空时默认进入首页 | |
OrderId | 订单Id | N | String | F机票H酒店T火车票I国际机票G国际酒店 | 根据订单Id的前缀跳转到对应订单详情 | |
TravelType | 差旅类型 | N | String | 0:因公出行 1:因私出行 | 传空时员工自行在系统选择因公或因私出行。ServiceType为1和4时,TravelType不生效。 | |
LoginCorpCode | 登录企业账号 | N | String | 相对于CorpCode参数,如果LoginCorpCode不存在,则CorpCode既为对接企业账号也为登录企业账号,如果LoginCorpCode存在,则CorpCode为对接企业账号,LoginCorpCode为登录企业账号。登录企业账号:用户实际归属的企业的账号 | ||
Source | 来源 | N | String | 跳转来源 |
构造请求
单点登录是GET请求,所以之前放在消息头中Authorization的参数通过url传递。
签名参考2.3的签名机制进行签名, 并对6.1构造的Json字符串进行加密。
举例说明:
https://openapi.hwht.com/v3/urllogin?type=auth-v2&authId=5980×tamp=1625650235& nonce=B232770685373CEB51DA21E723E8FF96&signature=b97a7d4cc335…eba897&encrypt=0a82bf8e320973ffd631f0a7:7a535c2129905fc…2a968a9c45019461ee62f68bb5038