刷新访问 Token
你需要定时刷新访问 Token ,确保你的应用程序与 YCM 通过 API 接口连接。
注: 每 30 分钟需要刷新一次 API Token ,否则旧的访问 Token 将会失效,导致应用程序与 YCM 连接断开。
请求 URL
POST {base_url}/dm/open_api/oauth/token
请求参数
请求体参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
grant_type | 是 | String | 授权类型,此处固定为 refresh_token 。 |
refresh_token | 是 | String | 当前最新的刷新 Token。 |
响应参数
参数 | 类型 | 描述 |
---|---|---|
access_token | String | 新的访问 Token 。 |
refresh_token | String | 新的刷新 Token 。 |
token_type | String |
返回的 Token 类型。 对于YCM API,这个字段的值始终是 |
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
}