Trimoji Soft Skills API
此API允许您将Trimoji的个性评估能力直接集成到您的招聘平台或工作流程中。
Trimoji是为招聘人员提供的个性分析解决方案。它允许向候选人发送问卷，然后生成结果（PDF和网页）。一个关键功能是“Personi”，它代表了职位的理想画像。您可以将候选人的画像与Personi进行比较，以获得0到100的匹配分数。
访问密钥
所有API请求都必须通过Authorization标头中的partner_token进行身份验证。
大多数请求还需要在请求正文中包含customer_token，以标识特定的Trimoji客户账户。
| 变量 | 类型 | 描述 |
|---|---|---|
base_url |
字符串 | https://integration.trimoji.fr/api/v1/softskills |
partner_token |
字符串 | 您的唯一合作伙伴令牌。 |
customer_token |
字符串 | 您的客户的Trimoji API密钥。 |
端点
1. 获取活动
获取客户创建的活动（招聘信息）列表。
方法： POST /campaigns
请求体（JSON）：
{
"customer_token": "{{customer_token}}",
"query": "test" (可选)
}2. 创建Personi活动
为新活动创建一个新的Personi（理想画像）。
方法： POST /create/campaign
主要参数：
campaign_infos: 测试配置（简短、长、结果显示）。job_offer: 职位详情（标题、部门、描述、任务）。custom_id: 您对此职位的内部唯一标识符。
3. 创建Personi（独立）
创建一个理想画像，而不直接关联到即时活动。
方法： POST /create/personi
4. 发送评估给候选人
启动评估流程。生成候选人的唯一链接。
方法： POST /init
| 参数 | 描述 |
|---|---|
candidate_email |
必需。候选人邮箱。 |
callback_url |
用于自动接收结果的Webhook URL。 |
is_trimoji_sending |
如果为true，Trimoji会发送邮件。否则，您负责发送链接。 |
Webhook & 结果
测试完成后，Trimoji会向callback_url发送一个POST请求，包含：
- score : 匹配分数（0-100）。
- grade :
failed（失败），passed（通过），或excelled（优秀）。 - web_report : 完整网页分析的链接。
- file_urls : PDF文件的链接（概述、面试、入职引导等）。
5. 获取一个流程的结果
通过其ID获取已完成评估的详细信息。
方法： GET /profile/:process_id
6. 获取Personis
列出客户创建的所有理想画像（Personis）。
方法： POST /personis
7. 将一个流程匹配到一个Personi
将已通过测试的候选人与特定的职位画像进行比较，以获得新的分数。
方法： POST /matching
{
"process_id": "CANDIDATE_TEST_ID",
"personi_id": "IDEAL_PROFILE_ID"
}