接口列表
本节包含管理员账号根据appKey和secret获取accessToken接口等.
① AccessToken,即访问令牌。接口调用必备的公共参数之一,用于校验接口访问/调用是否有权限,有效期为7天,有效期内不需要重复申请,可以重复使用;
② 有效期7天无法变更,请在业务端使用AccessToken的场景中,校验老Token的有效性和失效时重新获取Token的机制;
③ 新获取Token不会使老Token失效,每个Token独立拥有7天生命周期 接口列表如下:
序号 | 接口功能 | 描述 |
---|---|---|
1 | 根据appKey和secret获取accessToken | 用于管理员获取accessToken |
根据appKey和secret获取accessToken
接口功能
该接口用于管理员账号根据appKey和secret获取accessToken,appKey和secret可以在官网-开发者服务-我的应用中找到
注意:获取到的accessToken有效期是7天,请在即将过期或者接口报错10002时重新获取,每个token具备独立的7天生命周期,请勿频繁调用避免占用过多接口调用次数。
请求地址
https://open.ys7.com/api/lapp/token/get
请求方式
POST
- 请求参数
参数名 | 类型 | 描述 | 是否必选 |
---|---|---|---|
appKey | String | appKey | Y |
appSecret | String | appSecret | Y |
- HTTP请求报文
POST /api/lapp/token/get HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded
appKey=9mqitppidgce4y8n54ranvyqc9fjtsrl&appSecret=096e76501644989b63ba0016ec5776
- 返回数据
{
"data": {
"accessToken": "at.7jrcjmna8qnqg8d3dgnzs87m4v2dme3l-32enpqgusd-1jvdfe4-uxo15ik0s",
"expireTime": 1470810222045
},
"code": "200",
"msg": "操作成功!"
}
- 返回字段
字段名 | 类型 | 描述 |
---|---|---|
accessToken | String | 获取的accessToken |
expireTime | long | 具体过期时间,精确到毫秒 |
- 返回码
返回码 | 返回消息 | 描述 |
---|---|---|
200 | 操作成功 | 请求成功 |
10001 | 参数错误 | 参数为空或格式不正确 |
10005 | appKey异常 | appKey被冻结 |
10017 | appKey不存在 | 确认appKey是否正确 |
10030 | appkey和appSecret不匹配 | |
49999 | 数据异常 | 接口调用异常 |