导航
壳牌

介绍

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

使用温室实施整合188bet安卓APP

要开始集成过程,请将以下信息发送到Partners@greenhouse.io:188bet安卓APP

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

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

工作流

评估伙伴将向客户提供组织级别的API密钥。该组织将向其温室客户经理提供此API密钥,由其输入我们的系统。188bet安卓APP

选择测试

一旦Gre188bet安卓APPenhouse输入了该组织的API密钥,一个新的合作伙伴面谈阶段将可供使用。用户可以将此阶段添加到任何可以访问新的Assessment Partner阶段的作业的Hiring Plan中。188bet安卓APP然后,Greenhouse将对测试端点列表确定组织已配置了哪些测试。

添加舞台形象

发送测试

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

添加舞台形象

接收测试结果

188bet安卓APPGreenhouse将定期轮询测试状态端点检索考生的测试状态和结果。当候选人完成测试时,Greenhouse将通知适当的用户测试已经完成。188bet安卓APP用户将能够查看候选人的分数,导航到合作伙伴网站查看更多细节,并在Greenhouse内做出提前或拒绝决定。188bet安卓APP用户还可以通过分数来筛选候选人,并批量提前或拒绝候选人。

另外,Greenhouse的评188bet安卓APP估API现在包括通过PATCH -将测试标记为已完成端点避免长轮询!

身份验证

Greenhouse向评估合188bet安卓APP作伙伴的API发送的每个请求都将利用HTTPS上的HTTP基本身份验证。因此,我们要求每个API端点都使用HTTPS。

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

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

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

例子情况

一般考虑

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

评估API更改日志

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

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

列出测试

188bet安卓APP温室首先需要使用评估伙伴的测试列表使用list_testsAPI端点。我们将向用户显示可用测试的列表,用户将为给定的候选对象选择适当的测试。

得到https://www.testing-partner.com/api/list_tests

旋度“https://www.testing-partner.com/api/list_tests”-H“授权:基本MGQwMzFkODIyN2VhZmE2MWRjMzc1YTZjMmUwNjdlMjQ6”

请求

188bet安卓APPGreenhouse将向list_tests由评估伙伴指定的端点。

回复

API的反应

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

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

属性名 类型 必需的 描述
partner_test_id 字符串 是的 标识可用于组织的测试。
partner_test_name. 字符串 是的 测试的描述性标题。我们将使用这个值作为UI的测试标签。

发送测试

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

请求

卷曲-X帖子“https://www.testing-partner.com/api/send_test”-H“授权:基本MGQwMzFkODIyN2VhZmE2MWRjMzc1YTZjMmUwNjdlMjQ6”
{“partner_test_id”:“12345”,“候选人”:{“first_name”:“哈利”,“姓”:“波特”,“resume_url”:“https://hogwarts.com/resume”,“phone_number”:“123-456-7890”,“电子邮件”:“hpotter@hogwarts.edu”,“188bet安卓APPgreenhouse_profile_url”:“https://app.188bet安卓APPgreenhouse.io/people/17681532?application_id = 26234709 "},“URL”:“https://app.188bet安卓APPgreenhouse.io/integrations/testing_parters/take_home_tests/12345”}

188bet安卓APPGreenhouse将通过向send_test由评估伙伴指定的端点。POST请求的主体将包含一个JSON有效负载。

属性名 类型 必需的 描述
partner_test_id 字符串 是的 标识可用于组织的测试。初始时作为对测试列表请求
first_name 字符串 是的 候选人的名字。
last_name 字符串 是的 候选人的姓。
resume_url 字符串 候选人简历的URL。该URL将在请求后30天过期。
phone_number 字符串 候选人的电话号码。
电子邮件 字符串 是的 候选人的电子邮件地址。测试应该寄到这个地址。
188bet安卓APPgreenhouse_profile_url 字符串 是的 到候选Greenhouse应用程序的URL。188bet安卓APP允许合作伙伴链接回Greenhouse。188bet安卓APP
url 字符串 是的 对象发送到的补丁完成测试要求,如果使用

回复

API响应

{“partner_interview_id”:“98765”}

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

属性名 类型 必需的 描述
partner_interview_id 字符串 是的 标识候选人的测试。

PATCH -将测试标记为已完成

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

补丁https://app.gree188bet安卓APPnhouse.io/integrations/testing_parters/take_home_tests/12345

请求

curl - x片“https://app.188bet安卓APPgreenhouse.io/integrations/testing_partners/take_home_tests/12345”-H“授权:基本MGQwMzFkODIyN2VhZmE2MWRjMzc1YTZjMmUwNjdlMjQ6”

此请求不需要任何参数。

回复

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

发送温室更新188bet安卓APP

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

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

如果您已经实现了PATCH Completed Test选项:

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

测试状态

讲述温室的当188bet安卓APP前现状带回家测试。

得到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”

188bet安卓APP温室会发送一个得到请求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”,“笔记”:“这个候选人做得非常好!”}}

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

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

响应错误

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

文章https://www.testing-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”}

在收到畸形回复后,Greenhouse将向评估合作伙伴提供失败回复的详细信息188bet安卓APP。每次有无效响应到达时,Greenhouse将发送一个POST请求到188bet安卓APPResponse_Error.API端点。

请求的主体将包含Greenhouse在失败时刻所拥有的所有信息。188bet安卓APP

例如,如果是list_tests如果请求失败,Greenhou188bet安卓APPse只能提供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 找不到请求的资源。