웹훅을 사용하여 자신의 시스템으로 이벤트 보내기

웹훅은 무언가가 발생할 때, 예를 들어 송장이 지불될 때 IDup이 귀하의 웹 주소를 호출할 수 있게 합니다. 모든 전송은 서명되며 귀하의 시스템이 응답하지 않으면 반복됩니다.

엔드포인트 추가

1. 열기 웹훅 탭하고 누르세요 엔드포인트 추가.
2. 입력 이름 그리고 URL. 공개적으로 접근 가능해야 합니다. 보안상의 이유로 사설 네트워크 내의 주소는 거부됩니다.
3. 체크 이벤트 원하는 대로.
4. 선택 사항: 선택 API 키. 그런 다음 엔드포인트는 이 키가 읽을 수 있는 이벤트만 수신합니다.
5. 누르기 저장. IDup은 표시합니다 귀하의 서명 비밀 한 번. 안전하게 보관하세요.

이벤트

• 송장 생성됨, 송장 결제됨, 결제 수령
• 새 고객, 새 연락처, 새 리드, 새 티켓
• 오퍼 수락됨 — 고객이 수락한 견적서

모든 배송에는 세 가지 헤더가 포함됩니다: 이벤트 이름, 배송 번호 및 서명. 재시도 시 동일한 배송 번호가 유지되어 시스템이 중복을 인식할 수 있습니다.

서명 확인

시스템은 비밀 키를 사용하여 시간과 원시 본문에 대해 HMAC-SHA256을 계산하고, 이를 서명과 비교하며, 5분 이상 지난 시간을 거부해야 합니다. 누르세요 서명 확인 및 예시 기성 코드를 위해.

테스트, 일시 중지 및 갱신

• 테스트 보내기 테스트 이벤트를 보내고 HTTP 코드와 소요 시간을 표시합니다.
• 일시 중지 배송을 중지합니다; 활성화 다시 시작합니다.
• 비밀 롤 새로운 비밀을 생성합니다. 이전 것은 즉시 작동을 멈춥니다.
• 삭제 엔드포인트를 제거합니다. 로그는 유지됩니다.

재시도 및 로그

귀하의 주소는 5초 이내에 2xx 코드로 응답해야 합니다. 리디렉션은 따르지 않습니다. 실패할 경우 IDup은 1분, 5분, 30분, 2시간, 12시간 후에 다시 시도합니다. 여섯 번째 시도 후에는 배달이 표시됩니다. 포기함.

로그는 이벤트, 엔드포인트, 시도, HTTP 코드, 지속 시간 및 응답 시작과 함께 각 시도를 보여줍니다. 상태는 대기 중, 배달됨, 실패 또는 포기함. 사용하세요 다시 보내기 배송을 다시 보내세요.