获取 Access Token¶
通过应用的AccessKey和SecretKey获取Access Token。
Access Token与AccessKey对应。通常,一个AccessKey对应一个Access Token,即,如果已经生成了一个Access Token,再次调用获取Access Token接口后,依然会返回已经生成的Access Token。
前提条件¶
登录EnOS应用门户的开发者控制台,通过应用注册,获取应用的AccessKey和SecretKey,作为接口中 appKey 和 appSecret 参数的值,用于调用置换服务的外部接口,获取Access Token。
请求格式¶
POST https://{apigw-address}/apim-token-service/v2.0/token/get
请求参数(Body)¶
名称  | 
必需/可选  | 
数据类型  | 
描述  | 
|---|---|---|---|
appKey  | 
True  | 
String  | 
应用的AccessKey  | 
encryption  | 
True  | 
String  | 
加密密文,参考 加密密文生成规则>>  | 
timestamp  | 
True  | 
Long  | 
当前系统的时间戳,UNIX时间,精确到毫秒,例如:1572574909697  | 
加密密文生成规则 ¶
依次拼接
appKey、timestamp、appSecret的值,生成一个待加密串。使用 SHA256 算法加密待加密串生成预密文。
将预密文转换成小写字母,生成加密密文。伪代码如下:
sha256(appKey+timestamp+appSecret).toLowerCase();
响应参数¶
名称  | 
数据类型  | 
描述  | 
|---|---|---|
status  | 
Integer  | 
状态码,0表示成功  | 
msg  | 
String  | 
提示信息  | 
business  | 
String  | 
业务参数,为固定值:apim-token-service  | 
data  | 
data结构体  | 
生成的Access Token及有效时间  | 
data结构体¶
名称  | 
数据类型  | 
描述  | 
|---|---|---|
accessToken  | 
String  | 
Access Token值  | 
expire  | 
Integer  | 
Access Token的过期时间,单位为秒,初始值为7200秒(即2小时)  | 
示例¶
请求示例¶
POST
https://{apigw-address}/apim-token-service/v2.0/token/get
{
    "appKey": "5acb82e7-a11e-4300-9164-c8b20b638e8b",
    "encryption": "87c6885cec7525e2f219f86a82b280cc8c2d6ff4040a4b5f8acf9aeeda37aba8",
    "timestamp": 1572574909697
}
响应示例¶
{
    "stauts": 0,
    "msg": "SUCCESS",
    "business": "apim-token-service",
    "data": {
        "accessToken": "Generated_Access_Token",
        "expire": 7200
    }
}