本接口用于用户登录方式获取token进行API接口签名验证的场景
接口地址:https://gp-sys.api.dc78.cn/Api/usr_login?
pid=企业代码
usr=门店用户
pwd=用户密码
gpid: 应用id
timestamp: 日期格式yyyyMMddHHmmss,如:20190820115428;注意:时间会进行校验,请保证时间误差不超过60分钟
nonce: 随机数
signtype: 签名方式,目前取值: sha1
验证串:gpid=gp1339f3a58baa98df&msid=6786&nonce=471044&pid=gpcs&pwd=123456&signtype=sha1×tamp=20261104235522&user=123xb,30461a27b7b0871c0dc3aae05387ce09c4991756
签名验证串:msg_sign=sha1(验证串)
最终请求地址及参数:
https://gp-sys.api.dc78.cn/Api/usr_login?gpid=gp1339f3a58baa98df&msid=6786&nonce=471044&pid=gpcs&pwd=123456&signtype=sha1×tamp=20261104235522&user=123xb&msg_sign=B62CC56C33FE08AD2F9BF00CD9CD06F6CA62B13F
请求参数说明
| 参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
请求示例
{}响应参数说明
| 参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
响应示例
{
"status": "1",
"info": "登录成功",
"code": "123xb",
"us_msid": 6786,
"us_name": "1137",
"msname": "果盘测试",
"msid": 6786,
"mcid": 4124,
"apihost": "http:\\/\\/ms-6786-online.api.dc78.cn\\/Api",
"expiryDate": "20351201",
"token_id": "d30dbfc8fb3692eeb603d7173e70fc50",
"token_key": "0692c7b5c31c96755f4a1caa0375e743b4c29843",
"token_expires": 1793870038,
"server_timestamp": 1793783638,
"server_time": "2026-11-04 17:13:58"
}注意:
1.返回的apihost为后续门店业务API请求的地址
2.返回的token_id,每次API接口请求时需要在GET参数中加上:token_id=xxxxxx
3.API请求GET参数签名时,用上述返回的token_key代替原ApiKey进行签名获取msg_sign
4.登录token为临时,有效期为token_expires,需要在失效前再次调用usr_login接口重新获取token,默认token有效期为24小时