提交工单
咨询集成、功能及报价等问题
通过本接口查询文件转码任务状态。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 中的 “2.1 公共请求参数”。
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
TaskId |
String |
是 |
文件转码任务 ID。 |
https://docs-api.zego.im/?Action=DescribeTranscodeStatus
&AppId=1234567890
&SignatureNonce=15215528852396
&Timestamp=1234567890
&Signature=7a2c0f11145fb760d607a07b54825013
&SignatureVersion=2.0
&IsTest=false
{
"TaskId": "task"
}
参数 | 类型 | 描述 |
---|---|---|
Code |
Int64 |
错误码。 |
Message |
String |
错误描述。 |
RequestId |
String |
请求 ID。 |
Data |
Object |
响应对象。 详见 Data 成员列表。 |
Data 成员如下:
参数 | 类型 | 描述 |
---|---|---|
FileHash |
String |
源文件哈希。 |
FileType |
Int64 |
源文件类型参数,可设置为 1、2、4、8、16、32,各参数值说明如下:
|
DestinationFileType |
Int64 |
目标文件类型参数,可设置为 16、256、512,各参数值说明如下:
|
FileName |
String |
源文件名称。 |
FileSize |
Int64 |
源文件大小,单位为字节。 |
Status |
Int64 |
文件转码状态,详情请参考下文中 status 字段说明表。 |
FileId |
String |
转码成功后返回的文件 ID。 |
“Status” 字段取值说明如下:
状态码 | 描述 |
---|---|
1 | 未上传。 |
2 | 已上传。 |
4 | 排队中。 |
8 | 转码中。 |
16 | 转码成功。 |
32 | 转码失败。 |
64 | 转码任务已取消。 |
128 | 受密码保护的文档。 |
256 | 文件内容过大,例如文档页数过多。 |
512 | Excel 文件标签数过多。 |
1024 | 文件内容为空。例如:PPT 内无幻灯片。 |
2048 | 转码服务器打开文件失败。 |
4096 | 不支持的目标文件类型。 |
8192 | 源文件为只读文件。 |
16384 | 转码服务器下载源文件失败。 可能的原因如下:
|
32768 | 检测到源文件中包含了转码工具无法处理的元素,如墨迹涂鸦等,请去掉这些元素后再进行转码。 |
32769 | 检测到 Word、Excel 和 PowerPoint 文件格式不合法,请确保源文件可以使用 Office 打开再进行转码。 |
32770 | 要转码的文件存在安全隐患,无法正常打开转码。请确保使用 Office 打开文件时不会提示编辑此文件可能会损害您的计算机 |
32771 | 动态 PPT 转码结束后,检测到有图片、音视频文件未正常导出,转码服务器将重试转码。 |
32772 | 文件大小过大,无法转码,请确保文件大小在限制的范围之内。 |
32773 | 打开文件时弹需要修复文件提示框(文件损坏)。 |
32774 | EOF 错误(文件内容不完整)。 |
{
"Code": 0,
"Message": "succeed",
"RequestId": "abcd123",
"Data": {
"FileHash": "abc",
"FileType": 1,
"DestinationFileType": 256,
"Status": 8,
"FileId": "fiaaaa"
}
}
以下仅列出了接口业务相关的返回码,公共返回码请参考 公共返回码。
返回码 | 说明 |
---|---|
60013 |
文件已经完成转码。 |
60014 |
不存在的文件转码任务 ID。 |
60015 |
不支持的源文件类型。 |
联系我们
文档反馈