Fedex Logo

웹훅
생성 웹훅 관리

웹훅 테스트


웹훅 URL 테스트 기능을 이용해 목적 URL(리시버/리스너 서버)에 반환되는 배송 조회 데이터 유형을 테스트해 보세요. Advanced Integrated Visibility 웹훅을 생성하기 전에 URL과 반환되는 데이터의 유효성을 검증할 수 있습니다.

탐색:

웹훅 URL 테스트 샌드박스 콘솔로 이동하는 방법은 다음과 같습니다.

  • 내 프로젝트(왼쪽 탐색 패널) -> Advanced Integrated Visibility 탭 -> 웹훅 URL 테스트 버튼 -> 샌드박스 콘솔에서 이 Advanced Integrated Visibility 테스트 클릭
  • API 카탈로그(왼쪽 탐색 패널) -> Advanced Integrated Visibility 검색/필터 내 Advanced Integrated Visibility 클릭 -> Advanced Integrated Visibility 카드:
    1. -> 개요 -> 문서 버튼 -> 샌드박스 콘솔에서 이 Advanced Integrated Visibility 테스트 클릭
    2. -> Docs -> 샌드박스 콘솔에서 이 Advanced Integrated Visibility 테스트 클릭

단계:

웹훅 URL 테스트 기능을 이용하려면 다음 단계를 따르세요.

  1. 웹훅 URL 테스트 버튼을 클릭합니다.
  2. 다음 테스트 변수를 입력합니다.
    필드 이름 설명

    목적 URL

    배송 조회 이벤트 데이터/페이로드를 수신할 URL입니다.

    • 현재 작동하고 유효한 목적 URL을 입력해야 합니다.
    • 입력된 목적 URL은 표준화된 구문 형식이어야 합니다(보안 https URL).

    보안 토큰

    Advanced Integrated Visibility 웹훅 응답을 인증 및 검증하기 위한 공유된 시크릿으로 사용됩니다.

    • 토큰 값의 길이는 최소 26자에서 최대 100자 사이여야 합니다.
    • 영문 대문자, 영문 소문자, 숫자가 각각 1개 이상 포함되어야 합니다.
    • 보안 토큰은 응답의 유효성을 검증하기 위한 해시 기반 메시지 인증 코드(HMAC)를 생성하는 데 사용됩니다.

    페이로드 언어

    드롭다운 목록에서 배송 조회 데이터를 번역할 언어를 선택합니다. 이용 가능한 6개 샘플 언어는 다음과 같습니다.

    • 영어(미국)(기본 설정)

    배송 조회 유형

    배송 조회 데이터를 수신할 응답 유형을 선택합니다.

    • 자세한 배송 조회 응답(이벤트의 전체 이력이 포함된 보안 배송 조회 데이터로 구성)(기본값)
    • 이벤트별 배송 조회 응답(가장 최근 이벤트 정보만 포함된 보안 배송 조회 데이터로 구성)(준비 중)

    배송 조회 이벤트

    패키지 배송 단계에서 발송물 이벤트 관련 이메일 알림을 받을 상위 카테고리를 하나 선택합니다. 상위 카테고리는 다음과 같습니다.

    • 발송
    • 배송 중
    • 배달
    • 예외 사항
    • 예상 배송 날짜

    상태 이벤트

    배송 조회 이벤트는 패키지 배송 단계에 포함됩니다. 수신할 배송 조회 이벤트를 선택합니다. 이용 가능한 10개의 샘플 상태 이벤트는 다음과 같습니다.

    1. 픽업됨
    2. 운송 중
    3. 배송 완료
    4. 배송 예외 사항

     

    참고: '상태 이벤트' 필드 값은 선택한 '배송 조회 이벤트 카테고리'에 따라 기입됩니다. '배송 조회 이벤트 카테고리'와 각각의 '상태 이벤트'에 관한 자세한 정보는 다음 표를 참조하세요.

     

    상태 이벤트 카테고리 상태 이벤트

    발송
    • 픽업됨

    배송 중
    • 운송 중

    배달
    • 배송 완료

    예외 사항
    • 배송 예외 사항

    예상 배송(준비 중)
    • 예상 배송일(예정된 픽업일 기준)(EDD)
    • 예상 배송 시간 범위(EDTW)

     

  3. FedEx Developer Portal 사용권 계약(FDPLA) 체크박스를 선택해 사용권 계약에 서명/동의합니다.
  4. 푸시 버튼을 클릭해 테스트 결과를 확인합니다.


응답 :

샌드박스 내 응답 변수는 다음과 같습니다.

  • 본문 – 샌드박스 콘솔 내 웹훅 URL 테스트 탭에 응답 변수가 포함됩니다.
  • 상태 – 테스트 결과 탭 내 이 섹션에 처리 중인 요청의 상태가 표시됩니다.

    • 샘플 성공 메시지:
    성공
    테스트 Advanced Integrated Visibility 배송 조회 이벤트 세부정보가 제공되었습니다.

 

Sandbox Console

Test Parameters

Add in test parameters and push to check if the URL receives test event data from Webhooks API calls.

The destination URL is where we will send you authentication codes and messages as well as Advanced Integrated Visibility payload notifications. Only HTTPS connections using TLS (SSL) 1.2 or higher protocol version that is configured with a certificate from a valid certificate authority is supported. (Character limit: 200)

The following are not valid destination URLs:
• All RFC1918 IP space<br>
• All fedex.com and its sub domain<br>
• IP addresses in the URL (including localhost, 127.0.0.1)

Security Token should be a minimum length of 25 characters and a maximum length of 100 characters, 1 upper case, 1 lower case, 1 numeric character.

Example: Y1F6OiVUQW2JPSElmRE9U0IY5

Payload languageThe language in which you will receive the tracking data. Currently payload language is only available in English
View a full list of languages

Currently detailed tracking is the only available tracking type.

Detailed Tracking
Detailed Tracking Response consists of secured data with the entire history of events.

Event-specific Tracking (coming soon)
Event-specific Tracking Response consists of secure tracking data with only the most recent event information.

Tracking event
These are different categories of tracking events in the shipment life cycle. select one or more of these categories. Then when an event in that category happens, we will trigger webhook notifications and send you a tracking payload response.

Select a tracking event in the package lifecycle to include

Copy copied

Status

Success

Test webhook tracking event details delivered successfully

Error

Test webhook tracking event details delivery failed

샘플 성공 메시지

테스트 이벤트 배송에 실패할 경우, 테스트 결과 탭에 상태가 오류로 표시되며 해당하는 오류 코드 및 오류 메시지가 함께 나타납니다.

샘플 오류 메시지:
오류 코드:<<error code>>
테스트 Advanced Integrated Visibility 배송 조회 이벤트 세부정보 전송에 실패했습니다.

샘플 오류 메시지

유효성 검사 규칙:

  • Advanced Integrated Visibility URL은 표준화된 구문 형식이어야 합니다.
  • Advanced Integrated Visibility URL 테스트 시 필수 필드는 비워 둘 수 없습니다.
  • 유효성 검사 성공 시:
    • FedEx가 샘플 이벤트 JSON이 포함된 요청을 전송합니다.
      • 참고: Advanced Integrated Visibility 목적 URL이 HTTP 상태 코드 200(확인)으로 FedEx에 응답해야 합니다.
  • 유효성 검사 실패 시:
    • FedEx가 200(확인) 외 다른 응답을 수신하면 Advanced Integrated Visibility 목적 URL 유효성 검사가 실패로 간주됩니다.
    • 테스트 결과 탭에 오류 코드 및 오류 메시지가 표시됩니다.

데이터 페이로드 계산기

데이터 페이로드 계산기는 수신 등록자가 웹훅 활동을 통해 생성되는 데이터 양을 추정하는 데 도움을 주기 위해 설계되었습니다. 일일 페이로드 크기, 발송물 수 및 배송 조회 이벤트에 대한 가시성을 제공하여 사용자가 데이터 사용 및 통합 계획에 대해 정보에 입각한 결정을 내리도록 도와줍니다.

계산기 사용

사용자는 다음 매개 변수를 입력할 수 있습니다.

  • 발송물 수
  • 발송물당 이벤트 수(기본값: 5)
  • 일일 페이로드 양(자동 계산)

이러한 입력값을 기준으로 계산기는 동적으로 다음을 표시합니다.

  •  총 배송 조회 이벤트 수
  •  일일 페이로드
  •  예상 총 데이터 크기

정보 참고 사항:

  •  발송물당 이벤트 수는 기본값이 5로 설정됩니다. 발송물당 평균 17~18개의 이벤트와 서비스 유형, 운송업체, 도착지에 따른 1~7일의 일반적인 배송 일정을 기준으로 계산됩니다. 평균 배송 시간은 3일로 가정합니다. 참고: 이 값은 사용자가 편집할 수 있습니다.
  •  일일 페이로드 양은 발송물 수 × 발송물당 이벤트(기본값: 5)로 계산됩니다.
  •  사용자는 발송물 수를 입력하고 '계산'을 클릭하기만 하면 결과를 생성할 수 있습니다. 다른 값은 기본 설정되거나 자동으로 계산됩니다.

법적 고지: 계산기를 통해 제공되는 모든 값은 근사치이며, 계획 목적으로만 사용됩니다.

Number of Shipments
Events per Shipment (default 5)
Daily Payload Volume (events per day)



Note: Displayed values are approximations and may not reflect exact usage metrics.
CLOSE

Response

Copy