README

在Lingo24，我们热爱语言。我们每天都在努力翻译文档、网站、工具和产品，帮助全世界的人们相互沟通。

翻译您的内容可能具有挑战性，但我们的目标是通过易于使用的工具、友好的人和先进的技术使它变得非常简单。

在翻译方面，Lingo24提供一系列专业人工翻译和高级机器翻译服务，所有这些都可以通过我们的翻译API访问。

这是一个PHP接口，使使用我们的API变得简单。

安装与要求

使用Composer安装Lingo24 API客户端很容易，只需将库作为依赖项包含在配置文件中即可。

"require": {
    "lingo24/api-client": "=2.*"
}

问题、评论、投诉、表扬？

如果您有问题或评论，并希望直接联系我们，请随时通过以下途径进行。我们热爱与开发者交流！

• 电子邮件：api [at] lingo24 dot com
• 论坛：Lingo24开发者门户

如果您在使用库时遇到任何问题，请在此项目的Bitbucket问题跟踪器上提交问题。

访问我们的高级机器翻译API

要开始使用API，您首先需要进行身份验证。您可以通过在Lingo24开发者门户注册时获得的身份验证信息来完成此操作。

$lingo24 = new \Lingo24\API\MT('your_user_key')

如果您没有_user_key，请访问我们的计划页面，注册一个访问计划。这包括我们的免费高级机器翻译_taster_计划，可以免费在英语、法语和西班牙语之间翻译100,000个单词。

完成此操作后，您可以自由使用API包装器公开的方法来翻译文本、获取源语言和目标语言。您还可以查看在线Lingo24 API文档中可用的方法。

访问我们的商业文档API

要开始使用API，您必须首先联系我们创建一个与您的Lingo24开发者门户账户关联的客户账户。商业文档API的身份验证使用OAuth2进行。要开始使用API功能，您的用户需要进行身份验证，您的应用程序应将用户重定向到我们的Ease客户端门户，将请求类型（code）、客户端ID和重定向URI作为POST参数传递。一旦授权，Ease门户将重定向用户并提供一个授权代码。然后可以使用授权代码创建库。

$lingo24Docs = new \Lingo24\API\Docs('your_client_id', 'your_client_secret', 'your_application_url', 'authorisation code');

完成此操作后，您可以自由使用API包装器公开的方法来创建和管理作业和项目。您可以在在线Lingo24 API文档中查看可用的方法。

项目向导

API客户端库提供“项目向导”作为脚本项目和工作创建的便捷方式。向导允许您添加多个源文件和目标区域，然后为每种组合创建工作。

$lingo24Project = (new \Lingo24\API\ProjectWizard('My Project'))
    ->setDomain($lingo24Domain)
    ->setService($lingo24Service)
    ->setSourceLocale($lingo24SourceLocale)
    ->addFile('/tmp/file1.txt', 'My First File')
    ->addFile('/tmp/file2.txt', 'My Second File')
    ->addTargetLocale($lingo24TargetLocale1)
    ->addTargetLocale($lingo24TargetLocale2)
    ->create($lingo24Docs);

上面的示例将创建一个包含四个工作的项目，每个文件/目标区域组合对应一个工作。一旦项目创建完成，就可以像使用业务文档API库一样正常使用，例如：

$lingo24Docs->confirmProject($lingo24Project);