导航

介绍

10bet网站开户Greenhouse集成了许多候选测试平台,包括代码测试、视频面试、性格测试等。我们创建了评估合作伙伴API,允许我们的客户将我们合作伙伴的评估无缝地集成到他们的温室访谈工作流中。10bet网站开户本文档概述了集成的最终用户体验以及如何实现它的技术细节。

使用温室实施整合10bet网站开户

要开始集成过程,请将以下信息发送到Partners@greenhouse.io:10bet网站开户

  1. 网址给你list_testsAPI呼叫
  2. 网址给你send_testAPI呼叫
  3. 网址给你test_status.API呼叫
  4. 一个示例API键

合作伙伴团队将配置端点url以创建评估阶段,并提供接收沙箱帐户访问的下一步,以测试集成。如果您正在构建供共同客户使用的集成,我们将需要关于温室帮助中心集成的文档。10bet网站开户

工作流程

评估伙伴将为客户提供ORG级API密钥。该组织将为他们的温室客户经理提供此API密钥,谁将进入我们的系统。10bet网站开户

选择测试

一旦温室进10bet网站开户入组织的API键,将使用新的伙伴面试阶段使用。用户可以将此阶段添加到任何可以访问新评估伙伴阶段的任何作业的招聘计划。10bet网站开户温室将使API呼叫列表测试端点确定组织已配置了哪些测试。

添加舞台形象

发送测试

当应聘者到达面试阶段时,用户将点击“发送测试”按钮,通过发送测试端点。10bet网站开户Greenhouse将把测试ID和候选人的电子邮件发送给评估合作伙伴,评估合作伙伴将把测试邮件发送给候选人。然后,评估合作伙伴将向Greenhouse发送这个唯一测试实例的ID。10bet网站开户

添加舞台形象

接收测试结果

10bet网站开户Greenhouse将定期轮询测试状态端点检索候选人的测试状态和结果。当候选人完成测试时,温室将通知适当的用户测试完成。10bet网站开户用户将能够查看候选人的分数,导航到合作伙伴网站,以查看更多详细信息,并在温室内进行进步或拒绝决定。10bet网站开户用户还将能够通过分数来过滤候选人,并在批量中提前或拒绝候选人。

或者,温室的评估API现在包括10bet网站开户通过通知所完成测试的温室的能力PATCH -将测试标记为已完成端点避免长轮询!

身份验证

每个请求温室都向评估伙伴的A10bet网站开户PI发送将利用HTTPS的HTTP基本身份验证。因此,我们需要每个API端点来使用HTTPS。

当组织决定利用评估伙伴的集成时,他们将为他们的Everyhouse客户经理提供他们的API密钥,以便该评估伙伴。10bet网站开户

10bet网站开户然后Greenhouse将使用该API密钥作为基本身份验证中的用户名向该组织发出所有请求。10bet网站开户Greenhouse将在API令牌后面附加一个:(冒号),然后对结果字符串进行Base64编码。

在收到请求后,评估伙伴应该检查API键,以确定是否应该允许请求以及应该返回哪些数据。

例子情况

一般考虑因素

除非另有说明,否则A​​PI方法通常符合以下内容:

评估API更改日志

下面的时间戳是东部时间。

日期 描述
2019年8月21日下午2:00:00 将更改日志和常规考虑部分添加到评估API文档中
2019年8月21日下午2:00:00 添加PATCH -将测试标记为已完成终点

列表测试

10bet网站开户温室首先需要使用评估伙伴的测试列表使用list_testsAPI端点。我们将向用户展示可用测试列表,谁将为给定候选人选择适当的测试。

获取https://www.tiesting-partner.com/api/list_tests.

卷曲“https://www.testing-partner.com/api/list_tests”-H“授权:基本Mgqwmzfkodiyn2vhzme2mwrjmzc1ytzjmmuwnjdlmjq6”

请求

10bet网站开户Greenhouse将向list_tests由评估伙伴指定的端点。

回复

API的反应

[{“partner_test_id”“12345”“partner_test_name”“我的第一次测试”},{“partner_test_id”“54321”“partner_test_name”“我的第二个测试”}]

评估伙伴的响应应该包括一个JSON有效负载,其中包含组织的测试对象列表。每个测试对象都应该包含键partner_test_id.partner_test_name。

财产名称 类型 必需的 描述
partner_test_id. 细绳 是的 识别组织可用的测试。
partner_test_name. 细绳 是的 测试的描述性标题。我们将使用此值我们的UI作为测试的标签。

发送测试

当温室用户向候10bet网站开户选人发送测试时,温室将向评估伙伴发送请求send_testAPI端点。然后,评估伙伴将通过电子邮件将指定的候选人电子邮件发送指定的测试。

请求

卷曲-X帖子'https://www.tiesting-partner.com/api/send_test'-H“授权:基本Mgqwmzfkodiyn2vhzme2mwrjmzc1ytzjmmuwnjdlmjq6”
{“partner_test_id”“12345”“候选人”{“first_name”“哈利”“姓”“波特”“resume_url”“https://hogwarts.com/resume”“电话号码”“123-456-7890”“电子邮件”“hpotter@hogwarts.edu”“10bet网站开户greenhouse_profile_url”“https://app.10bet网站开户greenhouse.io/people/17681532?application_id=26234709”},“URL”“https://app.10bet网站开户greenhouse.io/integrations/testing_parters/take_home_tests/12345”}

10bet网站开户Greenhouse将通过向send_test由评估伙伴指定的端点。POST请求的主体将包含一个JSON有效负载。

财产名称 类型 必需的 描述
partner_test_id. 细绳 是的 识别组织可用的测试。最初作为对此的回应提供测试列表请求
first_name 细绳 是的 候选人的名字。
last_name 细绳 是的 候选人的姓。
resume_url. 细绳 候选人简历的URL。此URL将在请求后30天过期。
电话号码 细绳 候选人的电话号码。
电子邮件 细绳 是的 候选人的电子邮件地址。应将测试发送到此地址。
10bet网站开户Greenhouse_Profile_URL. 细绳 是的 到候选Greenhouse应用程序的URL。10bet网站开户允许合作伙伴链接回Greenhouse。10bet网站开户
url 细绳 是的 对象发送到的补丁完成测试要求,如果使用

回复

API响应

{“partner_interview_id”“98765”}

send_test请求的主体中应该包含一个JSON有效负载。这个有效载荷应该是一个包含单个键的单个对象:partner_interview_id

财产名称 类型 必需的 描述
partner_interview_id 细绳 是的 标识候选人的测试。

PATCH -将测试标记为已完成

当候选人完成测试时,将此请求发送到初始发送测试请求中发送的URL,以信号测试已完成的温室。10bet网站开户在此,温室将向您的测试10bet网站开户状态端点发送请求。

补丁https://app.gree10bet网站开户nhouse.io/integrations/testing_parters/take_home_tests/12345

请求

卷曲-X补丁“https://app.10bet网站开户greenhouse.io/integrations/testing_partners/take_home_tests/12345”-H“授权:基本Mgqwmzfkodiyn2vhzme2mwrjmzc1ytzjmmuwnjdlmjq6”

此请求不需要参数。

回复

响应将只返回HTTP状态代码。

将更新发送到温室10bet网站开户

如果你已经实现了轮询选项:

成功后send_test请求时,Green10bet网站开户house将通过轮询test_status.端点每小时。我们将停止投票test_status.端点后,我们收到partner_status完整的或者在8周之前通过了测试以来已经过测试。

如果您已实现修补程序已完成的测试选项:

成功后send_test请求,您可以通过发送一个预示温室来更新测试状态10bet网站开户的更新补丁完成测试中找到的URL请求url场的send_test要求。这将触发一个测试状态从温室的要求。10bet网站开户

测试状态

讲述温室的当10bet网站开户前现状带回家测试。

得到https://www.testing-partner.com/api/test_status?partner_interview_id=12345

请求

卷曲'https://www.tiesting-partner.com/api/test_status?partner_interview_id=12345'-H“授权:基本Mgqwmzfkodiyn2vhzme2mwrjmzc1ytzjmmuwnjdlmjq6”

10bet网站开户温室会发送一个得到请求test_status.终点由评估伙伴提供。这得到Request将包含一个查询字符串参数:partner_interview_id

参数名称 类型 必需的 描述
partner_interview_id 细绳 是的 为候选对象标识测试实例。最初作为对此的回应提供发送测试请求

回复

API的反应

{“partner_status”“完全的”“partner_profile_url”“http://example.com/tests/12345”“partner_score”81“元数据”{“开始了”“2014年3月26日上午10:15”“完成了”“2014年3月26日上午10:15”“笔记”“这位候选人非常好!”}}

对a的回应test_status.request应该在它的body中包含一个最多四个键值的JSON对象:partner_statuspartner_profile_urlpartner_score, 和元数据

财产名称 类型 必需的 描述
partner_status 细绳 是的 描述测试实例的当前状态。如果测试已经完成并获得结果,则应应为此值“完成”。我们将继续轮询,直到状态为“完整”,或者直到8周通过了自测试以来已通过。
partner_profile_url 细绳 仅在状态是时才需要完整的 在测试合作伙伴网站上的候选人页面的URL。
partner_score 数量 数字分数反映了候选人在测试中的性能。
元数据 对象 包含将在我们的测试结果中显示的键和值的非嵌套对象。所有值都必须是JavaScript原语。

响应错误

当Gree10bet网站开户nhouse收到针对任何评估伙伴的API端点的畸形响应时,我们希望将错误报告给评估伙伴。因此,每个评估伙伴都应该提供一个API端点来摄取此信息。

https://www.tiesting-partner.com/api/request_errors.

请求

卷曲-X帖子'https://www.testing-partner.com/api/request_errors'-H“授权:基本Mgqwmzfkodiyn2vhzme2mwrjmzc1ytzjmmuwnjdlmjq6”
{“api_call”“test_status”“错误”["partner_status是'complete',但partner_profile url缺失"),“partner_test_id”“12345”“partner_test_name”“人格测试”“partner_interview_id”“299506”“candidate_email”“hpotter@hogwarts.edu”}

收到畸形的反应后,温室将向评估伙伴提供失败响应的细节。10bet网站开户每次无效的响应到达时,温室都将发出帖子请求10bet网站开户Response_Error.API端点。

该请求的主体将包含在失败时期的温室的信息。10bet网站开户

例如,如果是list_testsRequest Fails,温10bet网站开户室只能提供API调用(在这种情况下,'list_tests')和什锦错误(缺少键,意外数据类型等)。但是,如果是test_status.请求失败,我们可以提供可能对调试目的有用的更多信息(partner_test_id,partner_interview_id等)。评估合作伙伴可以随时预期api_call.错误在json的身体里。

财产名称 价值 必需的 描述
api_call. 细绳 是的 生成格式化响应的API调用的名称。
错误 大批 是的 一个字符串数组,它描述了阻止响应验证的错误。
partner_test_id. 细绳 识别组织可用的测试。最初作为对此的回应提供测试列表请求
partner_test_name. 细绳 标识测试的人类可读字符串。最初作为对此的回应提供测试列表请求
partner_interview_id 细绳 标识候选人的测试。
candidate_email. 细绳 候选人的电子邮件地址。应将测试发送到此地址。

回复

API的反应

{“状态”200.}

对成功的回应response_errors请求应包含200的响应代码。

错误

成功的请求应使用200级状态代码生成响应。不成功的请求应生成以下答复之一的响应:

状态码 描述
401 使用提供的API密钥进行不成功的身份验证。
404 找不到请求的资源。