웹훅

웹훅을 사용하면 trimoji에서 이벤트가 발생할 때마다 (예: 테스트 완료, 캠페인 생성 등) 실시간 알림을 애플리케이션으로 보낼 수 있습니다. 이는 API에 불필요한 부담을 주지 않으면서 데이터를 동기화하는 가장 효율적인 방법입니다.

작동 방식: 이벤트가 발생하면 trimoji는 구성한 URL로 HTTP POST 요청을 보내 해당 데이터를 첨부합니다.

1단계

웹훅 설정

웹훅 관리는 고객 인터페이스의 "trimoji 계정"에서 진행됩니다. trimoji 계정으로 이동하세요.

설정 단계:

서버의 대상 URL을 입력합니다 (예: https://your-site.com/api/webhook).
수신할 이벤트를 선택합니다.
추가를 확인합니다.
중요: 웹훅을 생성하면 trimoji는 자동으로 고유한 Secret (Token)을 생성합니다. 이 토큰을 사용하여 엔드포인트를 안전하게 보호해야 합니다.

2단계

보안 및 인증

trimoji는 각 요청에 대해 생성된 비밀을 사용하여 요청을 서명하고 인증합니다. 요청이 실제로 당사 서비스에서 온 것인지 확인하기 위해 서버 측에서 이 정보를 확인해야 합니다.

토큰은 각 요청에서 두 가지 방식으로 전달됩니다:

HTTP 헤더: Authorization: YOUR_GENERATED_TOKEN
JSON 본문: { "_token": "YOUR_GENERATED_TOKEN", ... }

3단계

페이로드 구조

trimoji에서 보내는 모든 요청은 신속한 작업 식별을 위한 표준 JSON 형식을 따릅니다.

{
  "_token": "trimoji_generated_token",
  "_timestamp": "2026-02-11T16:00:00.000Z",
  "_event": "QUIZZ_COMPLETED",

  // 이벤트에 따른 동적 데이터
  "id": 12345,
  "data": 
    { ... }
  
}

4단계

사용 가능한 이벤트 목록

자동화 요구 사항에 따라 다양한 유형의 작업에 구독할 수 있습니다:

테스트 및 평가

QUIZZ_SENT
QUIZZ_COMPLETED

지원자 및 프로필

PROFILE_UPDATED
PROFILE_DELETED
PROFILE_RESTORED

캠페인 및 페르소나

CAMPAIGN_CREATED / UPDATED
PERSONI_CREATED

보안 및 흐름

AUTH_LOGIN
TRANSFER_INCOMING

5단계

기술 사양

User-Agent: 요청은 trimoji/1.0.0 식별자와 함께 전송됩니다.
예상 응답: 서버는 200 OK 코드를 반환해야 합니다. 사용자 측의 오류가 발생하면 trimoji는 귀하의 계정 로그에 실패를 기록합니다.
형식: 요청 본문은 항상 JSON 형식입니다.