GenerateWebofficeToken - 获取Weboffice凭证

• 请确保在使用该接口前，已充分了解智能媒体管理产品的收费方式和价格。

• 访问凭证过期时间为 30 分钟，刷新凭证过期时间为 1 天。

• 返回的过期时间为 UTC 时间，和北京时间有 8 小时的时差。

• 支持的输入文件格式：

  • 文字文档（Word）：doc、docx、txt、dot、wps、wpt、dotx、docm、dotm、rtf。

  • 演示文档（PPT）：ppt、pptx、pptm、ppsx、ppsm、pps、potx、potm、dpt、dps。

  • 表格文档（Excel）：et、xls、xlt、xlsx、xlsm、xltx、xltm、csv

  • PDF 文档：pdf。

• 支持最大的文件 200MB。

• 支持最大的文档页数 5000 页。

• 2023-12-01 之前创建的项目，按照文档打开次数计费。当前按照 API 接口调用次数计费。如需切换成新的计费模式，创建新的项目即可，但需要注意，一次 API 调用只能给一个用户使用，若重复使用，则只有最后一个用户可以正常访问，其余用户的访问权限将被回收。

• 在与智能媒体管理相同的地域下开通 MNS 服务，创建主题和队列，并配置订阅关系，可以通过 NotifyTopicName 参数传入 MNS 主题名称来接收文件保存的消息通知。关于 MNS SDK 的更多信息，请参见接收和删除消息。 文件保存消息通知 Message 字段 JSON 格式示例请参考 WebOffice 消息通知格式。

典型场景举例

对于如下示例的参数结构，对一些经典的场景示例说明：

预览只读文件（如果是预览 pdf 文件，必须这样设置）

文档预览模式，文档只能预览不可编辑规则：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.pdf",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

预览文件后缀为大写的文件

预览文件后缀为大写的文件，需要设置 Filename 参数后缀为小写：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.DOCX",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

对指定文档只预览前 5 页

文档一共 10 页，只显示前 5 页规则：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

对指定文档预览添加密码

文档预览时设置密码，或者源文件设置了密码预览时直接打开不需要密码规则：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Password" : "123456",
    "Permission" : "{'Readonly':'true'}"
}

对指定的文档预览添加水印

文档预览时添加水印规则：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Watermark" : "{'Type':'1','Value':'水印值','Font':'bold 20px Serif'}",
    "Permission" : "{'Readonly':'true'}"
}

对指定的文档预览时隐藏工具栏

文档预览时隐藏工具栏规则：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Hidecmb" : "true",
    "Permission" : "{'Readonly':'true'}"
}

对指定的文档进行在线编辑，查看历史版本，拷贝，打印，导出 PDF 权限

文档在线编辑，查看历史版本，拷贝，打印，导出 PDF 权限规则：

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Permission" : "{'Readonly':'false','History':'true','Copy':'true','Print':'true','Export':'true'}"
}

常见错误

ProjectName 对应的项目未找到，请到新版本 IMM 控制台检查地域下该项目是否存在。

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource acs:imm::xxx:project/xxx is not found"
}

User 参数是必填参数，请检查该参数是否填写。

{
    "Code": "InvalidArgument.User",
    "Message": "The parameter User is required but not provided"
}

User 参数不正确，请检查该参数值是否是正确的 JSON 格式。

{
    "Code": "InvalidJSON parsing error, User",
    "Message": "Specified parameter JSON parsing error, User is not valid."
}

Permission 参数不正确，请检查该参数值是否是正确的 JSON 格式。

{
    "Code": "InvalidJSON parsing error, Permission",
    "Message": "Specified parameter JSON parsing error, Permission is not valid."
}

Watermark 参数不正确，请检查该参数值是否是正确的 JSON 格式。

{
    "Code": "InvalidJSON parsing error, Watermark",
    "Message": "Specified parameter JSON parsing error, Watermark is not valid."
}

PreviewPages 参数格式不正确，请检查 PreviewPages 参数值。

{
    "Code": "InvalidPreviewPages",
    "Message": "Specified parameter PreviewPages is not valid."
}

SourceURI 对应的 OSS 文件不存在，请检查 Bucket 下该文件是否存在。

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource oss://xx is not found"
}