概述
登录认证服务用于获取身份令牌(access_token),身份令牌是调用平台进项服务以及票据服务的凭据,调用者通过应用参数向登录认证服务获取令牌,令牌有效期为24小时。
登录认证服务有特定的请求地址,由诺e票平台提供。
公共请求参数
调用方式:HTTP协议
调用方式:POST请求
数据格式:json
调用地址(测试环境):http://122.112.255.28:15012/login
请求报文规范
{
"username": "用户名",
"timestamp": "时间戳",
"signtype": "签名方式",
"signature": "签名值"
}
字段说明
数据项 | 名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|---|
username | 用户名 | varchar | 8 | 是 | 用户唯一身份标识,由诺e票平台提供。 |
timestamp | 时间戳 | varchar | 14 | 是 | 格式:yyyyMMddHHmmss |
signtype | 签名方式 | varchar | 16 | 是 | 默认为:HMacSHA256 |
signature | 签名值 | varchar | 是 | 将username+ timestamp+ signtype 的内容进行拼接后, 进行含有密码(用户名对应的密码,由诺e票平台提供)的散列函数算法, 得到结果转为大写作为签名值传入,用于平台校验。 |
返回报文规范
{
"code": "响应代码",
"msg": "响应描述",
"username": "用户名",
"access_token": "身份令牌",
"expiredtime": "过期时间",
"signtype": "签名方式",
"signature": "签名值"
}
字段说明
数据项 | 名称 | 类型 | 长度 | 说明 |
---|---|---|---|---|
code | 响应代码 | varchar | 4 | 0000:成功 其他:失败 |
msg | 压缩标识 | varchar | 当 code 不为 0000时,返回错误信息。 | |
username | 用户名 | varchar | 8 | 用户唯一身份标识,由诺e票平台提供。 |
access_token | 身份令牌 | varchar | ||
expiredtime | 过期时间 | varchar | 19 | 固定为:86400,单位秒,即24小时。 |
signtype | 签名方式 | varchar | 默认为:HMacSHA256 | |
signature | 签名值 | varchar | 将username+ signtype+ code+ msg + access_token + expiredtime 的内容进行拼接后, 进行含有密码(用户名对应的密码,由诺e票平台提供)的散列函数算法, 得到结果转为大写作为签名值传入。 |