获取ACCESS_TOKEN

请求方式

项	值
URI	/v1/getAccessToken.json
描述	请求令牌
请求方式	GET/POST
注意事项	无
其他	无

请求参数

属性名	类型	备注
appId	String	开放平台颁发的 appId
secret	String	开放平台颁发的 secret

请求示例

GET https://api.kinyun.cn/v1/getAccessToken.json?appId=APPID&secret=SECRET

或

POST https://api.kinyun.cn/v1/getAccessToken.json

{
    "appId": "APPID",
    "secret": "SECRET"
}

响应结果

{
    "code": 0,
    "msg": null,
    "data": {
        "accessToken": "YOUR_ACCESS_TOKEN", // 令牌
        "expire": 7200,                     // 令牌有效时间(单位: 秒)，默认2小时
        "ttl": 7200                         // 此令牌还有多少秒失效
    },
    "pageDto": null
}

测试ACCESS_TOKEN

API提供一个测试ACCESS_TOKEN用的回文接口(echo.json)。如果ACCESS_TOKEN可用，这个接口将会把开发者传入的msg再原样返回。

请求方式

项	值
URI	/v1/echo.json
描述	测试ACCESS_TOKEN用的回文接口
请求方式	POST
注意事项	无
其他	无

请求参数

属性名	类型	备注
msg	String	任意文本消息（长度不超过256字符），服务器会直接原样返回给开发者。

请求示例

POST https://api.kinyun.cn/v1/echo.json?token=ACCESS_TOKEN

{
    "msg": "TEXT_MESSAGE" // 任意文本消息
}

响应结果

调用成功

{
    "code": 0,
    "msg": null,
    "data": {
        "msg": "TEXT_MESSAGE" // 直接返回开发这传入的msg字段
    },
    "pageDto": null
}

调用失败

{
    "code":1000000408,
    "msg":"Invalid token",
    "data":null,
    "pageDto":null
}