随着最近向远程、随处工作模式的迁移，全球职位列表网站正变得越来越流行。但是，您的工作现场或求职者跟踪系统如何帮助雇主采取下一步措施，让求职者在其居住国被雇用和入职？输入远程 API！

借助远程 API，雇主无需离开您的平台，即可完成 60 多个国家/地区成功求职者的招聘流程。在本博客系列中，我们将提供使用远程 API 可以实现的不同级别的载入集成的示例。

本系列从这篇文章开始，我们提供了基本集成的说明，允许雇主通过单击平台中的按钮来启动员工入职，从而使招聘过程更快，更顺畅。本系列中的后续文章将为您提供构建块，以创建更深入的员工入职集成。

有了这个，让我们学习如何启动与远程API的集成！

开发轻量级集成

要启动能够改善客户生活并需要最少开发工作的集成，或者如果您只想在进行更深入的集成之前衡量客户兴趣，我们建议您从轻量级方法开始。

在与 Remote 的轻量级集成中，雇主可以选择他们想要在您的平台上雇用的候选人。只需单击一个按钮，他们就会被重定向到远程，在那里他们看到候选人已添加到我们的系统中，并准备开始国际入职流程。从这里开始，雇主只需添加一些合同详细信息，以便Remitary可以生成就业协议，邀请新员工添加其个人详细信息。Remote 负责其余的工作，以确保新员工在其所在国家/地区合规地被雇用，注册福利并设置工资单。

先决条件

重要的是要注意，这种轻量级集成有几个先决条件：

1. 客户必须已经是远程客户。如果不是，他们可以轻松快速地在线创建远程帐户。或者，你的团队可以询问我们有关使用“创建公司”终结点的信息，该终结点允许你为客户创建新的远程帐户。
2. 用户必须已经是远程用户。如果不是，他们可以要求其远程公司管理员将其添加到公司的远程帐户。或者，您的团队可以询问有关我们的公司经理终结点的信息，您可以使用该终结点在远程模式下为这些情况创建公司经理帐户。

先决条件

重要的是要注意，这种轻量级集成有几个先决条件：

1. 客户必须已经是远程客户。如果不是，他们可以轻松快速地在线创建远程帐户。或者，你的团队可以询问我们有关使用“创建公司”终结点的信息，该终结点允许你为客户创建新的远程帐户。
2. 用户必须已经是远程用户。如果不是，他们可以要求其远程公司管理员将其添加到公司的远程帐户。或者，您的团队可以询问有关我们的公司经理终结点的信息，您可以使用该终结点在远程模式下为这些情况创建公司经理帐户。

注册成为 API 合作伙伴

当您注册为 API 合作伙伴时，Remote 将：

1. 与您联系，讨论如何将全球就业解决方案直接嵌入您的平台并批准您的申请。
2. 让您能够访问我们详细的 API 文档。
3. 使用客户端凭据设置以访问远程 API。
4. 提供对演示环境的访问权限，以便您可以测试集成。
5. 在 Remote 中创建集成实体，以便使用您的集成的任何公司都链接到您的实体，并且您将能够读取和管理这些客户的数据。
6. 在 Remote 的 UI 中突出显示您的 API 集成，以共享有关您公司的信息以及入门说明，供所有客户查看。这对您的公司来说是一个很大的可见性，因为远程的所有客户都会在这里看到您，无论他们是否已经注册了您的服务！

准备好立即开始成为 API 合作伙伴的旅程了吗？立即注册Remote以了解更多信息！

构建许可流

Remote 已实施 OAuth 2 授权代码流，因此我们的客户可以同意 API 集成合作伙伴访问和管理其在 Remote 中的资源。当新用户首次尝试使用您的 API 集成时，他们将看到集成可以执行的操作，并被要求提供同意。通过集成执行的所有操作都是代表登录用户执行的。

远程将与您的团队合作，为您的集成实施正确的许可流。实现许可流后，集成的新用户的流将如下所示：

1. 用户尝试在您的平台中执行需要集成的操作（例如，单击使用 Remote 的 EOR 服务雇用新候选人的选项）。
2. 应用程序将用户重定向到 Remote 的授权页。
3. 如果用户已登录，则会将他们直接发送到 Remote 的授权页面。如果用户当前未登录到 Remote，我们会将他们重定向到登录页面，并在其中输入其 Remote 用户名和密码，并重定向到 Remote 的授权页面。快速提示：您可以使用 /v1/sso-url 跳过用户登录要求，这将为用户创建一个活动会话。
4. 在授权页面上，用户可以看到集成希望代表他们执行的操作，并可以选择是允许还是拒绝访问。
5. 用户完成许可流后，将使用您提供给 Remote 的回调 URL 将他们重定向回您的应用程序。
6. 当用户被重定向回您的应用程序时，您将在 URL 的查询字符串中收到授权代码。您可以交换授权代码以获取刷新令牌和有效的访问令牌。
7. 应用程序将在授权标头中传递访问令牌，以供将来代表用户执行操作的 API 请求使用。
8. 在第一个公司用户启用集成后，该公司的所有管理员用户都可以在远程 UI 中看到已启用集成。他们还可以看到其公司中已同意集成的用户列表。
9. 在远程 UI 中，管理员用户还可以为其公司禁用集成或删除特定用户对集成的访问权限。

远程 API 文档中提供了有关实现授权代码流的详细说明和代码示例。

将新员工的基本详细信息发送到远程，并将用户重定向到远程平台

当您平台中的用户表示他们希望继续招聘应聘者时，您可以将应聘者的详细信息发送到 Remote，同时将用户重定向到 Remote 的平台，在那里他们将看到新员工的个人资料，并将新员工移动到入职流程的下一阶段。

要将应聘者的详细信息发送到 Remote，请向 POST /v1/employment 发送请求，其中包含以下必需的详细信息：

1. company_id：客户的远程 ID。此值在刷新令牌响应中返回。它不会改变，所以请随时存储它以备将来参考。您还可以通过向 GET /v1/companies 发出请求来获取公司 ID。
2. country_code：候选人将被雇用的国家/地区。在撰写本文时，Remote支持在60多个国家/地区（并且正在快速增长）招聘。如果用户尝试在不受支持的国家/地区招聘，您将收到来自 API 的错误响应，并可以使用它来提醒您的用户。
3. 候选人的full_name、job_title、personal_email和provisional_start_date。这些详细信息将用于在 Remote 和应聘者之间代表客户创建雇佣协议。

当远程收到 POST 请求时，将创建新的雇用记录。新员工将显示在 Remote 的“入职”页面中。

将用户重定向到远程的载入页面，以便他们可以完成添加远程所需的任何其他详细信息，并邀请员工在远程中完成载入。在将用户登录重定向到“载入”页面时，有两个选项可用于处理用户登录：

1. 将用户重定向到 Remote 的登录页面，他们可以在其中输入用户名和密码或使用 SSO 登录。如果他们已经在 Remote 中有一个活动会话，他们将绕过登录页面。
2. 使用 GET /v1/sso_url 获取用户的重定向 URL 并绕过登录页。选择此选项时，可以传递以下参数：

• user_id：远程中的用户 ID。此值在刷新令牌响应中返回。它不会改变，所以请随时存储它以备将来参考。还可以通过向 GET /v1/公司经理发出请求并与用户的电子邮件地址进行匹配来获取用户的 ID。
• action=redirect_to_onboarding&user_id=<user_id>：将用户重定向到其公司的载入页面

就是这样！现在，您可以与 Remote 进行令人愉快的集成，无论求职者身在何处，它都能帮助您的客户更快地实现其招聘目标！

请求访问远程 API 并立即开始构建！

希望本指南能激发出有关如何使用远程 API 解决客户首要难题的新想法。我们只是触及了如何使用API构建简化的客户流的表面。请继续关注本系列中的更多内容，我们将在其中更深入地了解我们的API功能，并探索与Remitude构建全面API集成的其他可能性！
在 Remote，我们相信一起学习，倾听开发人员社区的反馈，并根据收到的反馈不断改进。我们的远程 API 现已推出，因此请立即请求访问我们的开发人员文档并分享您的反馈！