刷新访问 Token

你需要定时刷新访问 Token ,确保你的应用程序与 YCM 通过 API 接口连接。

注: 每 30 分钟需要刷新一次 API Token ,否则旧的访问 Token 将会失效,导致应用程序与 YCM 连接断开。

请求 URL

POST {base_url}/dm/open_api/oauth/token

请求参数

请求体
1.
参数 是否必填 类型 描述
grant_type String 授权类型,此处固定为 refresh_token
refresh_token String 当前最新的刷新 Token。

响应参数

2.
参数 类型 描述
access_token String 新的访问 Token 。
refresh_token String 新的刷新 Token 。
token_type String

返回的 Token 类型。

对于YCM API,这个字段的值始终是 bearer

expires_in Integer 访问 Token 的到期时间。

时间单位:秒 (s)。

示例

请求示例

POST /dm/open_api/oauth/token HTTP/1.1
Host: ycm.yeastar.com
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&refresh_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21Kd3RQYXlsb2FkSW5mbyI6eyJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ5c0lkIjoxNzg5NjM2MDM5MDg1MDI1NzM0OSwidmVyc2lvbiI6MTYzODk1OTkwOSwicmVmcmVzaFZlcnNpb24iOjE2Mzg5NjA0MzN9LCJzY29wZSI6WyJhbGwiXSwiYXRpIjoiMWQ5OTE4ZWUtNDg5MC00M2M2LTljOGYtMjYzMjFlMDU1ZjY5IiwiZXhwIjoxNjQwMjU2NDMzLCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiI3OGY4NDc4YS1iZGJmLTRjYzAtODVjMC0zMzQ3ZDU4YWU3NDIiLCJjbGllbnRfaWQiOiJrcDl5eW50bXVlc3VrNWpvV3ZNa1RiQ0J4cU82TEtSaCJ9.mShzSqjjixXgAZ3Cd5DiA4C1OVRzYrAqjfypE0A5mAg
1. Postman中的请求示例

响应示例

HTTP/1.1 200 OK
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21Kd3RQYXlsb2FkSW5mbyI6eyJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ5c0lkIjoxNzg5NjM2MDM5MDg1MDI1NzM0OSwidmVyc2lvbiI6MTYzODk1OTkwOSwicmVmcmVzaFZlcnNpb24iOjE2Mzg5NjA0NDZ9LCJzY29wZSI6WyJhbGwiXSwiZXhwIjoxNjM4OTYyMjQ2LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJmMGI2NzQ5ZC1mNDBiLTRmMDgtYTdkMi01MDg4ZDQ0ZDIzYzAiLCJjbGllbnRfaWQiOiJrcDl5eW50bXVlc3VrNWpvV3ZNa1RiQ0J4cU82TEtSaCJ9.BN4uvFadlTJvVdTcTFzVJLGqISzzUicxASSiDv8utss",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21Kd3RQYXlsb2FkSW5mbyI6eyJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ5c0lkIjoxNzg5NjM2MDM5MDg1MDI1NzM0OSwidmVyc2lvbiI6MTYzODk1OTkwOSwicmVmcmVzaFZlcnNpb24iOjE2Mzg5NjA0NDZ9LCJzY29wZSI6WyJhbGwiXSwiYXRpIjoiZjBiNjc0OWQtZjQwYi00ZjA4LWE3ZDItNTA4OGQ0NGQyM2MwIiwiZXhwIjoxNjQwMjU2NDMzLCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiI3OGY4NDc4YS1iZGJmLTRjYzAtODVjMC0zMzQ3ZDU4YWU3NDIiLCJjbGllbnRfaWQiOiJrcDl5eW50bXVlc3VrNWpvV3ZNa1RiQ0J4cU82TEtSaCJ9.oqpB9mDUSdswLOddhl_LpYDX06vaO_ZUEDRePhWukRw",
    "token_type": "bearer",
    "expires_in": 1799
}