网关接口
主要使用场景:该类接口主要使用于开发者获取访问令牌
1、获取接口访问令牌
开发者调用平台接口的第一步,访问令牌是开发者使用接口的凭证,通过访问令牌开发者可以使用自身权限下的各种接口。
请求说明
url |
/apigateway/getAccessToken |
协议 |
post |
参数说明
序列号 |
字段名 |
约束 |
类型 |
说明 |
1 |
appId |
必选 |
String |
应用ID |
2 |
timeStamp |
必选 |
String |
时间戳 |
3 |
keyInfo |
必选 |
String |
对APPID、APPKEY、Timestamp进行sha1-hamc运算,加密串为APPID和APPKEY及Timestamp字符串相连,以APPKEY为加密参数;
Php使用的签名函数:hash_hmac,hash_algos参数值为"sha1",具体的工具类请开发文档中下载SDK。 |
4 |
sysCode |
必选 |
String |
应用接入的区域编码级别,国家级默认为0,其他区域为国家标准6位行政编码,例:110000 |
返回说明
序列号 |
字段名 |
约束 |
类型 |
说明 |
1 |
retCode |
必选 |
String |
返回码 |
2 |
retDesc |
必选 |
String |
返回码描述 |
3 |
data |
必选 |
JSON |
返回的token对象信息 |
3.1 |
validTime |
必选 |
String |
返回token有效期,默认2小时后的时间戳。 |
3.2 |
userId |
必选 |
String |
应用创建人ID |
3.3 |
appId |
必选 |
String |
应用ID |
3.4 |
accessToken |
必选 |
String |
访问令牌 |
3.5 |
appName |
必选 |
String |
应用名称 |
3.6 |
appLvl |
必选 |
String |
应用级别(0:国家级;1:省级;2:地市级;3:区县级;4:机构) |
示例
请求报文:
{
"appId":"5736915E311EA64DEA******",
"keyInfo":"E4AA972000C1262169743C******",
"timeStamp":"1458282******",
"sysCode":"420100"
}
应答报文:
{
"data": {
"validTime": "14670914******",
"appKey": "8583C30ED82CFC4169C4******",
"userId": "00000032132",
"appId": "B1901B73D882387798AA5******",
"accessToken": "77b117c4069e4f74b2434******",
"appName": "5736915E311EA64DEA49547******"
},
"retCode": "000000",
"retDesc": "成功"
}