개발자

웹훅

워크스페이스에서 일어나는 일을 내 시스템에 알립니다. 고른 이벤트에 대한 서명된 호출로, 재시도와 기록이 있습니다.

이벤트

  • 파트너: 생성, 업데이트, 삭제, 상태 변경, 등급 변경, 매니저 변경.
  • 지급 방법: 생성, 업데이트.
  • 양식 요청: 생성, 업데이트, 삭제.
  • 전환: 생성, 업데이트, 상태 변경.
  • 정산과 지급: 정산 생성, 지급 상태 변경.
  • 오퍼: 생성, 업데이트, 삭제. 접근 권한 부여, 접근 권한 회수.
  • 포스트백: 실패.
  • 화이트라벨: 생성, 업데이트, 삭제.

만드는 법

  1. 설정 › 개발자 › 웹훅 › 새 웹훅: 엔드포인트 URL과 이벤트.
  2. 다음일 때만 보내기(선택): 레코드 항목에 대한 규칙. 모두 또는 하나라도, 값, 목록, 다른 항목과 비교.
  3. 보낼 내용: 호환(기존 연동이 기대하는 짧은 형식) 또는 전체 레코드(모든 항목, 변경 시 이전과 이후 값). 고를 때마다 예시가 바뀝니다.
  4. 엔드포인트에 필요하다면 추가 헤더.

서명 확인

모든 호출에는 Signature 헤더가 있습니다. 웹훅의 서명 비밀 키로 본문을 계산한 HMAC-SHA256입니다. 비밀 키는 웹훅을 만들 때 한 번만 보이며, 새 비밀 키로 바꿉니다.

전달

  • 서버가 제대로 응답하지 않은 호출은 다시 시도합니다.
  • 전달 기록에 모든 호출, 시도, 보낸 내용이 나옵니다. 다시 보내기로 호출을 반복합니다.
  • 테스트 보내기는 가장 최근의 실제 레코드(또는 예시)로 이벤트를 보냅니다.
  • 20번 연속 실패하면 웹훅이 스스로 일시 중지되고 알림을 받습니다. 엔드포인트를 고친 뒤 다시 시작을 클릭하세요.

2026년 10월 18일에 앱과 대조함