人工翻译服务器 API

我们最简单的 API

什么是翻译 API?

人工翻译服务器(HTS,Human Translation Server)是一项网站服务,可以将 Translated 的翻译服务直接集成到您公司的工作流程或内容管理器中。

您的内容管理系统(CMS)可向人工翻译服务器(HTS)发出请求以获取报价,并直接在我们的服务器上下达翻译订单。整个流程就如同普通客户在我们的网页上点击即时报价按钮下单一样。这些翻译订单最终将自动以“服务器到服务器”的方式直接递交到您的系统中。

在工作流程中集成人工翻译服务器(HTS)的优点:

  • 节约成本:即刻减少行政和管理成本。
  • 快速:下单后只需几个小时,您的文本就能完成翻译并在您的网站发布。
  • 稳定:零错误多语种管理流程。告别复制粘贴!
  • 便捷:实时报价和交付计划,无需与销售往来联络获取报价。

您只需为订购的翻译付费。人工翻译服务器没有安装成本和月租费用。您可以通过我们的在线报价查看人工翻译费用。如需了解更多信息,请发送邮件至 hts@translated.com 与我们联系。

入门

本节介绍相关流程。人工翻译服务器(HTS)的交互基本上由三个步骤组成:报价确认交付

报价

您可以通过以下 URL 发出请求(GET 或 POST 请求),申请报价,并在我们的系统内下单:

请见以下示例:

  • 函数 (f) “quote”
  • 客户 (cid) “hts-demo”
  • 密码 (p) "hts-demo5"
  • 源语言 (s) “english”
  • 目标语言 (t) “japanese”
  • 文件 (text) “blob”
  • 文件格式 (df) “pdf”
  • 如需交付至您可访问的公共端点 (endpoint),请访问http://www.yourdomain.com/translations/receive.php

此时,我们已提取文件并将其存储到我们的系统中,项目开始启动。在您的 blob(二进制大对象)文件完全传输完毕前,您的请求一直处于挂起状态。因此,您的网络传输速度越快越好。

建议:如果您的网络传输速度较慢,请考虑先将文件上传到某个地方,然后在“text”参数中将文件链接告知我们。如需了解更多详细信息,请参阅函数列表

您还需要为我们指明交付翻译文件的端点。请注意,如果没有端点信息,我们将无法交付翻译。

我们的系统通过 w 参数从您的文档中提取纯文本并计算相应字数(如果您没有在请求内容中明确提供字数)。
如需了解更多详细信息,请参阅函数列表,而后,我们将发出报价回复,具体如下:

含义
1 请求成功
OK “OK”或错误信息(如存在错误)
2013-09-26T15:30:00Z 保证的交付日期(祖鲁时间)(ISO 8601)
3082 我们计算的字数
216.99 欧元价格
1040734 报价 ID(项目 ID)

请注意,此时您的翻译项目尚未开始,我们只是向您提供以下信息:

  • 费用
  • 预计的交付日期和时间
  • 我们计算的总字数
  • 唯一对应的识别码

如需确认订单,您必须提交确认请求

确认

查看并批准报价后,请您回传以下数据确定订单:

https://www.translated.net/hts/?f=您要求的函数&cid=您的客户 ID&p=您的密码&pid=项目 ID&c=确认标志

请见以下示例:

https://www.translated.net/hts/?f=confirm&cid=hts-demo&p=hts-demo5&pid=1040734&c=1
  • 函数 (f) “confirm”
  • 客户 (cid) “hts-demo”
  • 密码 (p) "hts-demo5"
  • 项目 (pid) "1040734"
  • 确认标志 (c) "1"

如前所述,您可以发送 GET 或 POST 请求。如果确认成功,您将收到以下回复:

含义
1 请求成功
OK “OK”或错误信息(如存在错误)

这样就可以了!项目已得到确认并移交至我们的一位项目经理,他/她将负责根据您的内容挑选最适合的译者。您需要做的便是耐心等待最终交付。

交付

从专业译者那里拿到译文后,我们将进行仔细检查。如果译文通过了质量检查,我们会将译文传送至事先与您商定的 HTTP 端点(例如:http://www.your-domain.com/translations/receive.php)。

该端点随时可能收到我们的 POST 请求,其中包含以下字段:

  • pid:项目 ID
  • t:目标语言
  • text:译文 blob 文件(base64编码)

如果您订购了多种目标语言的翻译服务,您将分别收到每种目标语言的译文。此流程与报价流程之间的主要区别在于,报价是您方激活的“拉式”函数,而交付是我们触发的“推式”函数。

请见以下 PHP 示例:

参数 描述
Return Code 如交付成功则为 1,
如有错误则为 0
Error Message 如没有错误,显示“OK”;否则将显示错误信息。
错误信息应是易于理解的信息,并说明出现了什么问题。

如需个性化的工作流程,请发送电子邮件至 hts@translated.com 与我们联系。

测试环境

人工翻译服务器(HTS)带有用于测试目的的沙盘环境,它使我们能够在无需实际创建订单的情况下生成和发送翻译请求。沙盘环境准确模拟了 API 流程,使您能够实际看到从报价到交付的整个过程。

在对先前要求报价的项目进行确认时(“f=confirm”),您只需要添加“sandbox=1”参数,即可测试 API 确认流程,如下所示:

https://www.translated.net/hts/?f=confirm&cid=hts-demo&p=hts-demo5&pid=1040734&c=1&sandbox=1

请注意,报价函数也可使用同样的方式进行测试。此时,传回的文本将不是翻译文本,而是您发送给我们的报价文本,因为此举的目的是通过 API 创建一个测试项目。

如果您订购了多种目标语言的翻译,交付将分为多次完成,并随机间隔 30 秒 2 分钟不等的时间。

沙盘环境流程与实际过程完全相同,可以让您测试整个集成循环。

函数列表

每张表格中,必填参数均标红显示。

请求报价

此函数用于返回人工翻译的价格和交货日期。这是通过人工翻译服务器(HTS)订购人工翻译服务的第一步。

函数至少需要 text 或 w 参数值才能返回有效值。也就是说,在至少提供了字数参数时,您无需实际发送文档也可以获取有效的报价。

quote 函数接受以下参数:

参数 描述 默认 示例
cid 用户名 / cid=hts-demo
p 密码 / p=hts-demo5
s 源语言 / s=English
t 目标语言。
多个目标语言用逗号隔开
/ t=Italian
t=Italian,Spanish,Japanese
text 需要翻译的内容。可以是内联纯文本或指向文件的 URL。
请注意,如果已指定 w 参数值,则此参数为可选项。
/ text=Hello world
text="https://www.translated.net/hts/HTS_Tech_Spec.pdf"
pn 项目名称 HTS­-NONAME pn=Translation for tomorrow nr°2
jt 项目类型:

T,专业翻译服务
R,高级翻译服务
P,经济翻译服务
T jt=R
w 文件的字数。
该参数可以让我们的服务器跳过实时计算文件字数的步骤,从而提升处理速度。
/ w=5120
df 数据格式,文件的扩展名。自动字数计数所需参数。自动字词计数仅适用于:“pdf”、“plaintext”、“txt”、“xml”、“html”、“htm”、“xliff”、“zip”、“rtf”、“doc”、“docx” 和 “aea”。如需发送多个文件的压缩包,请指定“zip”格式。我们将自动猜测内容的文件格式。 / df=zip
tm 您希望用于该项目的翻译记忆库。text 参数可以是文件或 URL。请注意,您还可以传送 MyMemory 密钥。 / tm=823yuc908237
tm=http://www.yousite.net/hts/some_memory.tmx
endpoint 交付时,您希望我们发送译文的 URL。
我们建议您对端点进行 URL 编码,避免出现解析问题,尤其是链接包含“&”或其他特殊字符时。
/ endpoint=http://www.mysite.com/path/to/mypage.ext
URL­-encoded:endpoint=http%3A%2F%2Fwww.mysite.com%2Fpath%2Fto%2Fmypage.ext
subject 文件的主题。查看支持领域列表 API 方法获取完整列表。 general subject=accounting_finance
instructions 使用纯文本输入对译者的特殊指示。 / instructions=please leave all lowercase; dates are in US format

示例

https://www.translated.net/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese,italian&text=https://www.translated.net/hts/HTS_Tech_Spec.pdf&df=pdf&jt=P&pn=SimpleTest&w=3000

quote 函数返回以下字段:

参数 描述 示例
return code 如果交付成功则为 1,有错误则为 0 1
error message 如没有错误,显示“ OK”;否则显示错误消息 OK
delivery date 保证交付的截止日期和时间,以 ISO 8601 标准格式显示:YYYY­-MM­-DDTHH:mm:SSZ 2013­-02­-18T12:32:00Z
word count text 参数中给出的字数,由我们计算得出或由用户使用“w”参数提交 456
cost in Euro 订单费用,以欧元计价。格式为不带千位分隔符,以“.”作为小数点分隔符 223.33
project ID 确认订单时使用的项目 ID 10454289
确认订单

此函数用于确认先前请求过报价的人工翻译服务。这是通过人工翻译服务器(HTS)订购人工翻译服务的第二个步骤,也是最后一个步骤。

confirm 函数接受以下参数:

参数 描述 默认 示例
cid 用户名 / cid=hts-demo
p 密码 / p=hts-demo5
pid 确认订单时使用的项目 ID / pid=10454289
c 确认标志。
在“confirm”函数中的这个参数项内,输入 1 代表确认订单,输入 0 代表拒绝订单。
/ c=1
c=0
sandbox 沙盘模式。在这种模式下,项目被视作一个测试,需要翻译的内容将被原样发送到端点。不收取任何费用。 0 sandbox=1
text 需要翻译的内容。可以是:

内联纯文本/二进制大对象(binary blob)
指向文件的 URL
/ text=Hello world
text="https://www.translated.net/hts/HTS_Tech_Spec.pdf"

示例

https://www.translated.net/hts/?f=confirm&cid=hts-demo&p=hts-demo5&c=1&pid=232451

confirm 函数返回以下字段:

参数 描述 示例
return code 如果交付成功则为 1,有错误则为 0 1
error message 如没有错误,显示“ OK”;否则显示错误消息 OK
实时获取项目状态

使用此函数,您可以跟踪所有项目的状态。

status 函数接受以下参数:

参数 描述 默认 示例
cid 用户名 / cid=hts-demo
p 密码 / p=hts-demo5
pid 确认订单时使用的项目 ID / pid=10454289

示例

https://www.translated.net/hts/?f=status&cid=hts-demo&p=hts-demo5&c=1&pid=232451

status 函数返回以下字段:

参数 描述 示例
return code 如果交付成功则为 1,有错误则为 0 1
error message 如没有错误,显示“ OK”;否则显示错误消息 OK
该项目的任务列表,每行一个,用分号分隔值 一个任务行包含以下信息:ID;服务类型;源语言;目标语言;字数;总价;下单日期;交付时间;项目经理;项目经理电子邮件 one line job:
9687796;REVISION;Italian;English;182;10.00;IN PROCESS;2012­-11­-29 T15:35:00Z;2013­-01-­25 T16:00:00Z;GIANFRANCO;gianfranco@translated.com
支持语言列表

此函数显示人工翻译支持的语言代码列表(quote 和 confirm 函数中用于源语言和目标语言的参数)。列表包含 RFC 3066 代码、ISO 二字代码和 ISO 三字代码。

此函数应用于定期更新您系统上的语言列表

ll 函数接受以下参数:

参数 描述 默认 示例
cid 用户名 / cid=hts-demo
p 密码 / p=hts-demo5

示例

https://www.translated.net/hts/?f=ll&cid=hts-demo&p=hts-demo5

ll 函数返回以下字段:

参数 描述 示例
return code 如果交付成功则为 1,有错误则为 0 1
list of languages 一个语言行包括:语言名称;RFC3066 代码;ISO 639­1 代码;ISO 639­2 代码 Amharic;am­AM;am;amh
支持领域列表

此函数显示人工翻译的支持领域代码列表。此函数应用于定期更新您系统上的领域列表

subjects 函数接受以下参数:

参数 描述 默认 示例
cid 用户名 / cid=hts-demo
p 密码 / p=hts-demo5

示例

https://www.translated.net/hts/?f=ll&cid=hts-demo&p=hts-demo5

subjects 函数返回以下字段:

参数 描述 示例
return code 如果交付成功则为 1,有错误则为 0 1
list of subjects 翻译内容所属的领域 accounting_finance
aerospace_defence
architecture

常见问题

通过 HTS 获取订单报价但还未确认,该订单可以保留多久时间?
报价订单有效期为 24 小时。
支持那些文件格式?
我们支持任何类型的文件。HTS 只是一个下单工具和将文件直接传输到我们服务器上的渠道。但是,一些高级功能(如自动字数计数)仅支持 pdf、txt、xml、html、xliff、rtf、doc、docx 和 aea。对于其他格式,您需要自行计算字数,然后通过特定参数将确切字数发送给我们。详情请参阅 Quote 函数内容(函数列表)。
完成的译文如何回传?通过电子邮件吗?还是 FTP?
译文文件将通过 HTTP POST 请求传输到您选择的公共端点。请务必将端点信息发送给我们,否则我们将无法回传译文。
付款流程是什么样的?
我们会将每个项目的发票发送给您,请在 5 天内付款。对于大量翻译和定期合作的情况,我们可以安排费用月结。
对纯文本文件进行翻译,价格是否相同?
是的,价格不会变化。但是请注意,从文件中提取文本的工作越复杂,所需的时间就越多,项目也会相应延长时间。
为什么使用同一文件的不同格式计算字数,结果会略有不同?
系统通过解析文件、提取纯文本并计算字数来进行自动字数计数。更丰富的文件格式(如 Word 格式)可能包含其他元数据信息(文件注释、作者信息等),这些信息也会被提取出来。这会导致字数计数的微小差别。Translated 的项目经理会在翻译开始前对每个文件进行彻底检查,确保字数计数不会出现较大的出入。
如果自动字数计数功能不支持我的文件格式,我是否还可以使用 API?
可以的。HTS 支持任何文件类型。显示的支持格式仅用于在线自动字数计数。
如果我实在希望使用自动字数计数功能,该怎么办?
请通过 hts@translated.com 与我们联系,我们非常乐意与您进一步讨论。
我希望将一份内容翻译成多种语言,该怎么做?
在“t”参数中输入所需目标语言,用逗号隔开,如下所示:
https://www.translated.net/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese,italian,spanish&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive
我可以在不实际发送文件的情况下获得一个报价吗?
可以,使用字数参数“w”代替“text”参数,如下所示:
https://www.translated.net/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese&w=1000&df=pdf&endpoint=http://www.your-domain.com/translations/receive
API 还支持其他回复格式吗?
默认情况下,我们的 HTS 返回纯文本格式内容,但是,如果您指定“of=json”,它将返回 JSON。该可选参数支持 API 的所有函数(“quote”、“confirm”、“status”、“ll”、“subjects”)。
有测试环境吗?
我们的 HTS 提供沙盘测试环境,可以在不实际下单的情况下测试整个报价、确认订单和交付的流程。我们不对沙盘测试项目进行任何收费,也不对使用次数进行限制。您可以在相关章节中查阅详细说明。

还有其他问题?

我们的团队将竭诚为您提供人工翻译服务器(HTS)接入的相关支持。

联系我们