人工翻译服务器 API

我们最简单的 API

什么是翻译 API？

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

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

在工作流程中集成人工翻译服务器（HTS）的优点：

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

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

入门

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

报价

您可以通过以下 URL 发出请求（GET 或 POST 请求），申请报价，并在我们的系统内下单：

https://www.translated.net/hts/?f=YOUR-REQUIRED-FUNCTION&cid=YOUR-CUSTOMER-ID&p=YOUR-PASSWORD&s=SOURCE-LANGUAGE&t=TARGET-LANGUAGE&text=FILE-NAME&df=FILE-FORMAT&endpoint=http://www.YOUR-DOMAIN

请见以下示例：

https://www.translated.net/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive
  • 函数 (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）接入的相关支持。

联系我们