Trimoji Soft Skills API
이 API를 통해 Trimoji의 성격 평가 능력을 채용 플랫폼이나 워크플로우에 직접 통합할 수 있습니다.
Trimoji는 채용 담당자를 위한 성격 분석 솔루션입니다. 지원자에게 설문지를 보내면 결과(PDF 및 웹)가 생성됩니다. 핵심 기능은 직무에 대한 이상적인 프로필을 나타내는 "Personi"입니다. 지원자의 프로필을 Personi와 비교하여 0에서 100까지의 일치 점수를 얻을 수 있습니다.
접근 키
모든 API 요청은 Authorization 헤더의 partner_token을 통해 인증되어야 합니다.
대부분의 요청에는 Trimoji 고객 계정을 식별하는 요청 본문의 customer_token도 필요합니다.
| 변수 | 유형 | 설명 |
|---|---|---|
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 |
결과를 자동으로 받기 위한 웹훅 URL. |
is_trimoji_sending |
true이면 Trimoji가 이메일을 보냅니다. 그렇지 않으면 링크 전송을 직접 관리합니다. |
웹훅 & 결과
테스트가 완료되면 Trimoji는 callback_url로 POST 요청을 보냅니다. 포함되는 내용은 다음과 같습니다:
- score: 매칭 점수(0-100).
- grade:
failed,passed또는excelled. - web_report: 전체 웹 분석 링크.
- file_urls: PDF 링크(요약, 면접, 온보딩 등).
5. 프로세스 결과 가져오기
프로세스 ID를 통해 완료된 평가의 세부 정보를 가져옵니다.
메서드: GET /profile/:process_id
6. Personi 가져오기
고객이 생성한 모든 이상적인 프로필(Personi)을 나열합니다.
메서드: POST /personis
7. 프로세스를 Personi와 매칭
이미 테스트를 완료한 지원자를 특정 직무 프로필과 비교하여 새로운 점수를 얻습니다.
메서드: POST /matching
{
"process_id": "지원자_테스트_ID",
"personi_id": "이상적인_프로필_ID"
}