CreateDocTranslateTask - 机器翻译

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateDocTranslateTask	系统规定参数。取值：CreateDocTranslateTask。
SourceLanguage	String	是	en	原文语言，语言code参考
TargetLanguage	String	是	zh	目标语言，语言code参考
FileUrl	String	是	http://fileUrl	文档URL。
Scene	String	否	general	场景，支持：通用(general)、标题(title)、详情(description)、买卖家沟通(message)、医疗(medical)、社交(social)、科技(tech)。
CallbackUrl	String	否	http://callbackUrl	翻译结果回调URL。
ClientToken	String	否	token	提供幂等能力，3分钟内，相同的值只会生效一次。

返回数据


名称	类型	示例值	描述
Status	String	ready	任务状态。
RequestId	String	D3920BC3-A395-4CAD-9E84-7C39EB07507B	请求ID。
TaskId	String	0586df512c8b4bb382d7d9a6a01b5854	任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDocTranslateTask
&CallbackUrl=http://callbackUrl
&FileUrl=http://fileUrl
&SourceLanguage=en
&TargetLanguage=zh
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDocTranslateTaskResponse>
    <requestId>D3920BC3-A395-4CAD-9E84-7C39EB07507B</requestId>
    <taskId>0586df512c8b4bb382d7d9a6a01b5854</taskId>
    <status>ready</status>
</CreateDocTranslateTaskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CreateDocTranslateTaskResponse" : {
    "requestId" : "D3920BC3-A395-4CAD-9E84-7C39EB07507B",
    "taskId" : "0586df512c8b4bb382d7d9a6a01b5854",
    "status" : "ready"
  }
}

错误码


HttpCode	错误码	错误信息	描述
199	19999	An unknown error occurred.	未知异常
400	10021	The parameter is invalid.	参数无效。
400	10022	The parameter fileUrl is invalid.	参数fileUrl非法。
400	10023	The parameter fileUrl is not accessible.	参数fileUrl无法访问。
400	10024	The parameter callbackUrl is invalid.	参数callbackUrl非法。
400	10030	The file size exceeds the limit.	文件大小超过了限制。
400	10031	The specified file type is invalid.	文件类型不支持。
400	InvalidAccountStatus	The Machine Translation service has not been activated.	用户未开通机器翻译服务。
403	10029	The number of calls per day exceeds the limit.	超出单日调用次数限制。
403	Forbbiden	You are not authorized to operate on the specified resource.	用户未被授权操作指定的资源。

访问错误中心查看更多错误码。