刷新访问 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

响应示例

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