需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

响应状态码

更新时间不可用

查询互动白板 SDK 的响应状态码、错误码含义、常见原因和处理建议。

在调用互动白板 RESTful API 过程中，你可能收到如下 HTTP 状态码：

  • 如果状态码为 200 或 201，表示请求成功。

  • 如果状态码不为 200 或 201，则请求失败。响应包体中可能包含 code、title 和 messages 字段，描述失败的具体原因。

例如，请求失败时，你可能收到如下 400 Invalid request 响应：

JSON
{
    "error":{
        "code":"2010201",
        "title":"unsupported file format",
        "messages":[],
        "requestId":"iUxxxXS_gGxxxXWw",
        "region":"cn-hz",
        "traceStack":["cn-hz-shunt-api-7bxxxxxx8d-67stw"]
    }
}

HTTP 响应状态码

HTTP 响应状态码描述处理建议
200 OK请求成功，服务器成功返回请求的数据。无需处理。
201 Created请求成功，服务器成功新建或修改数据。无需处理。
400 Invalid request用户发出的请求有错误，服务器没有进行新建或修改数据的操作。根据响应包体中的 code 和 title 进行处理。详见文档转换错误码。
401 Unauthorized用户没有权限（Token 错误）。重新生成拥有对应权限的 Token。
403 Forbidden用户得到授权（与 401 错误相对），但是访问是被禁止的。检查房间或资源的访问权限。
404 Not found服务器无法找到请求的资源。检查请求内容是否正确。
500 Internal server error服务器内部错误，无法完成请求。重试或联系技术支持。
表格内容超出当前宽度，可横向滚动查看更多列。

文档转换错误码

调用文档转换 RESTful API 后收到的 HTTP 状态码为 400 Invalid request 时，在响应包体中会返回如下错误码 (code) 和错误标题 (title)：

codemessage描述处理方法
2010201unsupported file format用户上传了不支持的文件格式（如 PGN、JPG、JPEG、MP3、MP4 等）。上传支持的文件。
2010202dynamic conversion only support pptx用户上传的文件格式不支持动态转换。上传 PPTX 格式的文件。
2010203resource invalid资源无效。检查资源链接是否可以访问。
2010204the number of tasks exceeds limit转换队列中的任务过多。调用取消指定的文档转换任务以减少队列中的任务数量，或等待已有转换任务完成后再发起转换。
2010605task not found未找到要查询的任务。查询任务参数是否正确。
2011201task timeout任务超时。检查网络连接或压缩文件体积。
2010606team not found找不到用户信息。查询 Token 是否正确。在控制台中确认数据中心和文档转网页服务是否正确配置。
2010607modify priority for running task is not allowed无法修改正在运行的任务优先级。确保所修改的任务正在排队中。
2011301task not found传入的 taskid 查询不到任务。查询任务参数是否正确。
2030100download from OSS file failed源文件下载失败。检查文件是否已经上传。
2030101unzip file failed, unsupported file in PPT不支持的 PPT 格式。检查是否能使用 PowerPoint 打开此文件。
2030102can't find media file from unzip PPT解压后找不到媒体文件。检查 PPT 媒体文件位置是否正确，是否使用了外链。在用户电脑上测试，移动 PPT 其它文件夹后，打开 PPT 能否播放媒体文件。
2030200read xml file failed解压后的 XML 文件异常。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2030201formula resolve failed, please check animation of PPTXML 中的公式解析错误。检查或删除 PPT 内的动画并重试。
2030202unsupported formula type, please check animation of PPTXML 中的公式类型错误。检查或删除 PPT 内的动画并重试。
2030801Invalid parsing of display object (Type: slide; Page: 45; Object Name: Img 3)解析某个元素时出错。联系技术支持或者将错误元素删除后重新发起转换, 可根据错误消息中的 Page 和 Object Name 定位到错误元素的具体页码和名称。
2030802Invalid parsing of slide (Page: 11;)解析某个页面时出错。联系技术支持或者将错误页面删除后重新发起转换, 可根据错误消息中的 Page 定位到错误页面的具体页码。
2040005task timeout图片转换任务超时。文档内的图片可能异常或者体积过大，联系技术支持定位。
2050099unknown error未知的文档转图片异常。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2050100unsupported file type不支持的文件格式。上传 PPT 或 PPTX 文件。
2050101file download failed源文件下载失败。检查网络连接。
2050102file is empty文件内容为空。本地打开检查文件是否有内容。
2050107file url encode failed文件 URL 编码失败。检查文件路径是否正常。
2050201init presentation parser failed初始化 PPT 解析异常。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2050299unknown parsing error未知的文档解析异常。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2050401generate preview failed预览图生成失败。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2060402fonts in the rules that are not provided找不到指定字体。联系技术支持。
2090304upload file to custom storage failed上传文件到用户存储失败。检查存储配置是否正确。
2090305not supported storage provider不支持的云存储服务商。检查服务商链接是否正确或更换服务商。
2110099unknown error未知的文档转图片异常。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2110100unsupported file type用户传入了无法支持的文件格式。上传静态转换支持的文件（ ppt/pptx/doc/docx/pdf）。
2110101download file failed文件下载失败。检查文件地址是否有效。
2110102file is empty文件内容为空。本地打开文件，检查是否有内容。
2110107file url encode failed文件 URL 编码失败。检查文件路径是否正常。
2110108get file extension failed获取文件格式失败检查上传的文件是否直接修改过扩展名，但文件本身是不支持的格式。
2110201init presentation parser failed未知的 PPT 文档解析异常。检查上传的文件是否为非 PowerPoint 软件编辑（例如 WPS）。
2110202init word parser failed未知的 DOC 文档解析异常。检查上传的文件是否为非 Word 软件编辑（例如 WPS）。
2120201file is emptyPDF 文件内容为空。本地打开文件，检查是否有内容。
2120301download file failedPDF 文件下载失败。检查文件地址是否有效。
表格内容超出当前宽度，可横向滚动查看更多列。

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利