文件翻译结果查询

POST

接口描述

接口请求域名： tmt.tencentcloudapi.com 。

在调用文档翻译请求接口后，有回调和轮询两种方式获取识别结果。
•当采用回调方式时，翻译完成后会将结果通过 POST 请求的形式通知到用户在请求时填写的回调 URL，具体请参见文档翻译结果回调。
• 当采用轮询方式时，需要主动提交任务ID来轮询识别结果，共有任务成功、等待、执行中和失败四种结果，具体信息请参见参数说明。

默认接口请求频率限制：20次/秒。

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
FailedOperation	操作失败。

请求参数

Header 参数

X-TC-Action

string

必需

操作的接口名称。本接口取值：GetFileTranslate。

示例值:

GetFileTranslate

X-TC-Timestamp

integer

必需

当前 UNIX 时间戳，可记录发起 API 请求的时间。例如 1529223702。注意：如果与服务器时间相差超过5分钟，会引起签名过期错误。

默认值:

1529223702

X-TC-Version

string

必需

操作的 API 的版本。本接口取值：2018-03-21。

默认值:

2018-03-21

Authorization

string

必需

HTTP 标准身份认证头部字段，例如： TC3-HMAC-SHA256 Credential=AKIDEXAMPLE/Date/service/tc3_request, SignedHeaders=content-type;host, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024 其中， - TC3-HMAC-SHA256：签名方法，目前固定取该值； - Credential：签名凭证，AKIDEXAMPLE 是 SecretId；Date 是 UTC 标准时间的日期，取值需要和公共参数 X-TC-Timestamp 换算的 UTC 标准时间日期一致；service 为产品名，通常为域名前缀，例如域名 cvm.tencentcloudapi.com 意味着产品名是 cvm。本产品取值为 tmt； - SignedHeaders：参与签名计算的头部信息，content-type 和 host 为必选头部； - Signature：签名摘要，计算过程详见文档。

X-TC-Token

string

可选

安全凭证服务所颁发的临时安全凭证中的 Token，使用时需要将 SecretId 和 SecretKey 的值替换为临时安全凭证中的 TmpSecretId 和 TmpSecretKey。使用长期密钥时不能设置此 Token 字段。

X-TC-Language

string

可选

指定接口返回的语言，仅部分接口支持此参数。取值：zh-CN，en-US。zh-CN 返回中文，en-US 返回英文。

默认值:

zh-CN

Body 参数application/json

TaskId

string

任务ID

必需

示例

{
    "TaskId": "100001"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://tmt.tencentcloudapi.com' \
--header 'X-TC-Action: GetFileTranslate' \
--header 'X-TC-Timestamp;' \
--header 'X-TC-Version;' \
--header 'Authorization;' \
--header 'X-TC-Token;' \
--header 'X-TC-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "TaskId": "100001"
}'

返回响应

🟢200成功

application/json

Body

Response

object

必需

Data

object (GetFileTranslateData)

必需

RequestId

string

唯一请求 ID

必需

每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

示例

{
    "Response": {
        "Data": {
            "Status": "Wait",
            "FileData": "",
            "TaskId": "100001",
            "Message": "",
            "Progress": "80"
        },
        "RequestId": "xx"
    }
}

修改于 2022-09-15 08:19:01

文本翻译

文件翻译请求

文件翻译结果查询

接口描述#

错误码#

请求参数

示例代码

返回响应

接口描述

错误码