获取 Access token
无需签名
接口描述
access_token是全局唯一接口调用凭证,您在访问PingPong的各接口时都需要使用access_token。 您需要进行妥善保存。
access_token的存储至少要保留 512 个字符空间;access_token 的有效期为 2 小时,需定时刷新,重复获取将导致上次获取的access_token失效; 建议开发者使用中控服务器统一获取和刷新access_token,其他业务逻辑服务器所使用的access_token均来自于该中控服务器,不应该各自去刷新,否则容易造成冲突,导致access_token覆盖而影响业务; access_token的有效期通过返回的expire_in来传达,目前是7200秒之内的值,中控服务器需要根据这个有效时间提前去刷新。在刷新过程中,中控服务器可对外继续输出的老access_token; 为了避免token申请期间的请求还带着老token,access_token再重新申请之后,原有token在5分钟之内还有效,access_token 的有效时间可能会在未来有调整,所以中控服务器不仅需要内部定时主动刷新,还需要提供被动刷新 access_token 的接口,这样便于业务服务器在API调用获知access_token已超时的情况下,可以触发access_token的刷新流程
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string(64) | M | PingPong分配的app_id |
| app_secret | string(64) | M | PingPong分配的app_secret |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| access_token | string(255) | M | M |
| expires_in | int | M | M |
返回示例
- 成功
- 失败
{
"code": 0,
"message": "ok",
"data": {
"access_token": "<access_token>",
"expires_in": 7200
}
}
{
"code": 1001,
"message": "invalid app_id",
"data": null
}