Fedex Logo

VYTVOŘIT
WEBHOOK SPRAVOVAT WEBHOOKY

Testování webhooku


Pomocí funkce Otestovat adresu URL webhooku můžete otestovat typ dat sledování vracených na cílovou adresu URL (server příjemce/posluchače). Pomáhá to ověřit URL adresy a vrácená data před vytvořením webhooku Advanced Integrated Visibility.

Navigace:

Ke konzole sandboxu Otestovat adresu URL webhooku lze přejít následujícími způsoby:

  • Moje projekty (na levém navigačním panelu) -> karta Advanced Integrated Visibility -> tlačítko Otestovat adresu URL webhooku -> v konzole sandboxu klikněte na možnost Vyzkoušet tuto službu Advanced Integrated Visibility
  • Katalog API (v levém navigačním panelu) -> vyhledejte Advanced Integrated Visibility / klikněte na Advanced Integrated Visibility na kartě FILTRY -> Advanced Integrated Visibility:
    1. -> Přehled -> Dokumentace tlačítko -> v konzoli sandboxu klikněte na Zkusit tuto službu Advanced Integrated Visibility.
    2. -> Dokumentace -> v konzoli sandboxu klikněte na Zkusit tuto službu Advanced Integrated Visibility.

Postup:

Chcete‑li využít funkci Otestovat adresu URL webhooku, postupujte následovně:

  1. Klikněte na tlačítko Otestovat adresu URL webhooku.
  2. Zadejte následující parametry testu:
    Název pole Popis

    Adresa URL místa určení

    Jedná se o adresu URL, na které budete přijímat data nebo datový obsah událostí sledování.

    • Zákazník musí zadat funkční a platnou cílovou adresu URL.
    • Zadaná cílová adresa URL musí být ve standardizovaném syntaktickém formátu (zabezpečená adresa URL protokolu HTTPS).

    Token zabezpečení

    Používá se jako sdílený tajný kód pro ověření a validaci odpovědi webhooku Advanced Integrated Visibility.

    • Hodnota tokenu musí mít minimální délku 26 znaků a maximální délku 100 znaků.
    • Musí obsahovat alespoň 1 velké písmeno, 1 malé písmeno a 1 číslici.
    • Token zabezpečení se použije k vytvoření podpisu HMAC (Hash-based Message Authentication Code), který slouží k ověření odpovědi.

    Jazyk datové části

    V rozevíracím seznamu vyberte preferovaný jazyk pro překlad dat sledování. K dispozici je následujících 6 ukázkových jazyků:

    • Angličtina (USA)(výchozí)

    Typ sledování

    Vyberte typ odpovědi, ve které mají být data sledování přijímána.

    • Podrobná odezva sledování (tento typ odpovědi se skládá ze zabezpečených dat sledování s celou historií události).(Výchozí)
    • Odezva Sledování konkrétních událostí (tento typ odpovědi se skládá ze zabezpečených dat sledování pouze s nejnovějšími informacemi o události).(Již brzy)

    Sledování událostí

    Chcete‑li v rámci životního cyklu zásilky dostávat e‑mailová oznámení o událostech týkajících se zásilky, vyberte jednu kategorii vyšší úrovně. K dispozici jsou následující kategorie vyšší úrovně:

    • Odeslat
    • V přepravě
    • Doručení
    • Výjimky
    • Předpokládané doručení

    Událost stavu

    Událost sledování v rámci životního cyklu zásilky. Vyberte jednu z událostí sledování, kterou chcete přijímat. K dispozici je následujících 10 ukázkových událostí stavu:

    1. Vyzvednuto
    2. V přepravě
    3. Doručeno
    4. Výjimka při doručení

     

    Poznámka: Hodnoty pole Událost stavu se vyplní na základě vybrané kategorie událostí sledování. Další informace o  kategoriích událostí sledování a příslušných událostech stavu najdete v následující tabulce.

     

    Kategorie události stavu Událost stavu

    Odeslat
    • Vyzvednuto

    V přepravě
    • V přepravě

    Doručení
    • Doručeno

    Výjimky
    • Výjimka při doručení

    Odhadovaná doba doručení(Již brzy)
    • Předpokládané datum doručení (EDD)
    • Odhadovaná doba doručení (EDTW)

     

  3. Zaškrtnutím políčka Licenční smlouva FedEx Developer Portal (FDPLA) podepište/přijměte licenční smlouvu.
  4. Klikněte na tlačítko ODESLAT a prohlédněte si výsledky testu.


Odpověď:

V sandboxu jsou k dispozici následující parametry odpovědi:

  • Text – Text obsahuje parametry odpovědi na kartě Otestovat adresu URL webhooku v konzole sandboxu.
  • Stav – V této části na kartě Výsledky testu je uveden stav zpracovávaného požadavku.

    • Ukázka úspěšné zprávy:
    Úspěch
    Detaily sledovací události Advanced Integrated Visibility byly úspěšně doručeny.

 

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

Ukázka zprávy o úspěchu

Pokud doručení testovací události selže, na kartě Výsledky testu se jako STAV zobrazí Chyba s příslušným kódem chyby a chybovou zprávou.

Ukázka chybové zprávy:
Kód chyby:<<kód chyby>>
Doručení podrobností o testovacích událostech sledování služby Advanced Integrated Visibility selhalo.

Ukázka chybové zprávy

Pravidla ověřování:

  • Adresa URL služby Advanced Integrated Visibility musí být ve standardizovaném syntaktickém formátu.
  • Při testování adresy URL služby Advanced Integrated Visibility nesmí být žádné z povinných polí prázdné.
  • V případě úspěšného ověření:
    • Společnost FedEx odešle požadavek s ukázkovým kódem JSON události.
      • Poznámka: Cílová adresa URL služby Advanced Integrated Visibility by měla FedExu odpovědět s kódem stavu HTTP 200 (OK).
  • V případě neúspěšného ověření:
    • Pokud FedEx obdrží jinou odpověď než 200 (OK), bude ověření cílové adresy URL služby Advanced Integrated Visibility považováno za neúspěšné.
    • Společnost FedEx zobrazí kód chyby a chybovou zprávu na kartě Výsledky testu.

Kalkulačka datového obsahu

Kalkulačka datového obsahu je navržena tak, aby odběratelům pomohla odhadnout objem dat generovaných aktivitou webhooku. Poskytuje přehled o denních velikostech datového obsahu, počtech zásilek a sledovaných událostech – pomáhá uživatelům informovaně se rozhodovat o využití dat a plánování integrace.

Používání kalkulačky

Uživatelé mohou zadat následující parametry:

  • Počet zásilek
  • Počet událostí na zásilku (výchozí: 5)
  • Denní objem datového obsahu (počítá se automaticky)

Na základě těchto vstupů kalkulačka dynamicky zobrazuje:

  •  Celkový počet událostí sledování
  •  Denní datový obsah
  •  Odhadovaná celková velikost dat

Poznámky pro informaci:

  •  Výchozí hodnota událostí na zásilku je 5. Vychází z průměru 17–18 událostí na zásilku a obvyklých dodacích lhůt 1–7 dnů v závislosti na typu služby, dopravci a místě určení. Předpokládá se průměrná dodací lhůta 3 dny. Poznámka: Tuto hodnotu může uživatel upravovat.
  •  Denní datový obsah se vypočítá takto: Počet zásilek × Počet událostí na zásilku (výchozí: 5)
  •  K vygenerování výsledků stačí, když uživatel zadá počet zásilek a klikne na tlačítko „SPOČÍTAT“. Ostatní hodnoty jsou buď výchozí, nebo se vypočítají automaticky.

Zřeknutí se práv: Všechny hodnoty poskytnuté kalkulačkou jsou přibližné a určeny pouze pro účely plánování.

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