该接口用于刷新文档预览的 AccessToken (当前只支持上海,杭州,深圳,北京 Region)。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String RefreshOfficePreviewToken
AccessToken String 访问凭证,通过GetOfficePreviewURL 或者 RefreshOfficePreviewToken 返回
RefreshToken String 刷新凭证,通过GetOfficePreviewURL 或者 RefreshOfficePreviewToken 返回

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户
AccessToken String 访问文档预览服务器时的凭证
AccessTokenExpiredTime String 凭证过期时间,30分钟
RefreshToken String 凭证过期时,使用RefeshToken来刷新凭证
RefreshTokenExpiredTime String 刷新凭证的过期时间,1天

示例

请求示例

POST https://imm.cn-shanghai.aliyuncs.com
?Action=RefreshOfficePrviewToken
&Project=test
&AccessToken=ac80b70a70fe4c34914a12743ac3a6fb
&RefreshToken=44dd1a2012f5467bba1521b213e5a461
...

此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API。

成功返回示例

{
    "AccessTokenExpiredTime":"2020-02-04T10:53:47.999Z",
    "PreviewURL":"https://office-cn-shanghai.imm.aliyuncs.com/office/w/1023210024677934_a2_3899cdbd16b3061554556d9e949bb2fe85a944030bf147f8de1d79036f5e5a25?hidecmb=1&simple=1&_w_tokentype=1",
    "AccessToken":"ac80b70a70fe4c34914a12743ac3a6fb",
    "RefreshTokenExpiredTime":"2020-02-05T10:23:47.999Z",
    "RequestId":"F07DA595-194D-45A7-8752-ABBADBB1297F",
    "RefreshToken":"44dd1a2012f5467bba1521b213e5a461"
}

若在使用中有疑问,请参考 FAQ,或者进入 钉钉用户群 实时交流。