웹훅
생성 웹훅 관리

Advanced Integrated Visibility Tracking Number Subscription API를 사용해 웹훅 수신 등록에 배송 조회 번호를 추가하려면 다음 단계를 따르세요.

이전 섹션에 적힌 단계 또는 시작하기 가이드에 적힌 단계를 따라 Advanced Integrated Visibility 배송 조회 번호 구독 프로젝트를 생성합니다.
Advanced Integrated Visibility Tracking Number Subscription API 호출을 시작하려면 OAuth 토큰이 필요합니다. OAUTH 토큰은 Authorization API를 사용해 생성할 수 있습니다. OAUTH 토큰을 생성하는 자세한 방법은 API 카탈로그 내 Authorization API 문서를 참조하세요.
왼쪽 탐색 메뉴에서 프로젝트 세부정보를 클릭합니다. 프로덕션 키 탭에서 스크롤을 내려 Advanced Integrated Visibility Tracking Number Subscription API 문서를 찾습니다.

Advanced Integrated Visibility Tracking Number Subscription API 문서로 이동하면 다음 엔드포인트 3개가 보입니다.

배송 조회 번호 연결 엔드포인트

이 엔드포인트를 사용해 해당 웹훅 구독에서 배송 조회 번호를 추가하거나 제거합니다. 자세한 내용은 Advanced Integrated Visibility Tracking Number Subscription API 문서를 참조하세요.
배송 조회 번호 추가 또는 제거는 비동기식 작업입니다. Tracking Number Association API 호출을 추가하거나 제거할 수 있도록 작업 ID가 응답으로 전송됩니다.

배송 조회 번호 작업 세부정보 엔드포인트

이 엔드포인트는 해당 작업 ID에 관한 세부정보를 제공합니다. 세부정보의 예로는 제출된 모든 배송 조회 번호 중 해당 웹훅 구독에 추가된 배송 조회 번호 수 또는 아직 처리 중인 배송 조회 번호 수 등을 들 수 있습니다.

배송 조회 번호 작업 상태 엔드포인트

이 엔드포인트로 처리 중인 모든 작업의 현재 진행 상황 요약을 확인할 수 있습니다.

유효성 검사 규칙:

웹훅 이름은 고유해야 합니다.
웹훅 목적 URL은 표준화된 구문 형식이어야 합니다.
웹훅 생성 시 필수 필드는 비워 둘 수 없습니다.
웹훅 생성 시 이용 가능한 FedEx 발송 고객번호를 최소 1개 연결해야 합니다.
유효성 검사 성공 시:
- 웹훅이 생성되면 확인 메시지가 전송됩니다.
  샘플 확인 메시지: <<Webhook name>>이(가) 생성되었습니다. 변경 사항이 적용되는 데 최대 10분이 소요될 수 있습니다.
유효성 검사 실패 시:
- FedEx가 200(확인) 또는 202(수락) 외 다른 응답을 수신하면 웹훅 목적 URL 유효성 검사가 실패로 간주됩니다.

Response

Copy