top
关闭

开发者登录

认证类接口

主要使用场景:第三方应用接入平台后,需要与平台会话保持一致时使用

1、获取接口访问令牌

基础 需要授权

开发者调用平台接口的第一步,访问令牌是开发者使用接口的凭证,通过访问令牌开发者可以使用自身权限下的各种接口。

前置条件

请求说明

urlhttps://gateway.tianyuyun.com/apigateway/getAccessToken
请求方式post
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

序号 字段名 约束 类型 长度 说明

1

appId

必选

String

64

应用ID

2

timeStamp

必选

String

时间戳(毫秒)

3

keyInfo

必选

String

-

对APPID、APPKEY、Timestamp进行sha1-hamc运算,加密串为APPID和APPKEY及Timestamp字符串相连,以APPKEY为加密参数; Php使用的签名函数:hash_hmac,hash_algos参数值为sha1。

返回说明

序号 字段名 约束 类型 长度 说明

1

retCode

必选

String

10

返回码

2

retDesc

必选

String

100

返回码描述

3

tokenInfo

必选

Json对象

返回的token对象信息

3.1

validTime

必选

String

32

返回token有效期

3.2

platformCode

必选

String

10

所属平台编码

3.4

appId

必选

String

64

应用ID

3.5

accessToken

必选

String

64

访问令牌

3.6

appName

必选

String

64

应用名称

示例

请求报文:
{
	"appId":"5736915E311EA64DEA******",
	"keyInfo":"E4AA972000C1262169743C******",
	"timeStamp":"1458282******"
}
应答报文:
{
    "tokenInfo": {
        "validTime": "14670914******",
        "platformCode": ,
        "userId": "AP93******",
        "appId": "5736915E311EA64DEA******",
        "accessToken": "77b117c4069e4f74b2434******",
        "appName": "******"
    },
    "retCode": "000000",
    "retDesc": "获取Token成功。"
}