Fedex Logo

Webhook tesztelése


A „Webhook-URL tesztelése” funkcióval tesztelheti a cél-URL-címre (címzett/hallgató kiszolgáló) visszaküldött nyomonkövetési adatok típusát. Ez segít az URL és a visszaküldött adatok érvényesítésében a Speciális integrált láthatóság webhook létrehozása előtt.

Navigáció:

Az alábbi módon lehet belépni a Tesztwebhook URL-címének tesztkörnyezeti konzoljába:

  • Saját projektek (a bal oldali navigációs panelen) -> Speciális integrált láthatóság lap ->  Webhook -URL tesztelése gomb-> a tesztkörnyezeti konzolban kattintson a Próbálja ki ezt: Speciális integrált láthatóság lehetőségre
  • API-katalógus (a bal oldali navigációs panelen) -> keresse meg a Speciális integrált láthatóságot/kattintson a Speciális integrált láthatóság lehetőségre a SZŰRŐK -> Speciális integrált láthatóság kártyán:
    1. -> Áttekintés-> Dokumentáció gomb -> a tesztkörnyezeti konzolban kattintson a Speciális integrált láthatóság kipróbálása lehetőségre.
    2. -> Dokumentumok -> a tesztkörnyezeti konzolban kattintson a Speciális integrált láthatóság kipróbálása lehetőségre.

Lépések:

A következő lépések szükségesek a Tesztwebhook URL-címe terület használatához:

  1. Kattintson a Tesztwebhook URL-címe gombra.
  2. Adja meg a következő vizsgálati paramétereket:
    Mezőnév Leírás

    Cél-URL-cím

    Ez az az URL-cím, ahonnan a nyomonkövetési esemény adatai/fizetési adatai érkeznek.

    • Az ügyfélnek működő és érvényes rendeltetési URL-címet kell megadnia
    • A megadott rendeltetési URL-címeknek szabványos szintaktikai formátumban kell lenniük (biztonságos https-URL).

    Biztonsági token

    Megosztott titokként szolgál a Speciális integrált láthatóság webhook válaszának hitelesítéséhez és ellenőrzéséhez.

    • A token értékének legalább 26 és legfeljebb 100 karakter hosszúnak kell lennie.
    • Legalább 1 nagybetű, 1 kisbetű és 1 számjegy szükséges.
    • A biztonsági token a válasz érvényesítésére szolgáló HMAC-aláírás (Hash-based Message Authentication Code) létrehozására szolgál.

    Adattartalom nyelve

    Válassza ki a legördülő listából, melyik nyelvre szeretné lefordítani a nyomonkövetési adatokat. A következő 6 mintanyelv áll rendelkezésre:

    • Angol (Egyesült Államok) (Alapértelmezett)

    Nyomonkövetési típus

    Válassza ki azt a választípust, amelyben a nyomonkövetési adatokat fogadni kell.

    • Részletes nyomonkövetési válasz (A választípus biztonságos nyomonkövetési adatokból áll, és az esemény összes előzményét tartalmazza).(Alapértelmezett)
    • Eseményspecifikus nyomonkövetési válasz (A választípus csak a legfrissebb eseményinformációkat tartalmazó, biztonságos nyomonkövetési adatokból áll).(Hamarosan)

    Nyomonkövetési események

    Válasszon ki egy magasabb szintű kategóriát, ha e-mailes értesítéseket szeretne kapni a csomag életciklusának küldeményeseményeiről. Az alábbi magasabb szintű kategóriák érhetők el:

    • Feladás
    • Tranzitban
    • Kézbesítés
    • Rendkívüli események
    • Kézbesítés becsült ideje

    Állapotesemény

    Nyomonkövetési esemény a csomag életciklusában. Válassza ki azt a nyomonkövetési eseményt, amelyet fogadni szeretne. Az alábbiakban a rendelkezésre álló 10 minta állapotesemény található:

    1. Csomag felvéve
    2. Tranzitban
    3. Kézbesítve
    4. Rendkívüli esemény a kézbesítés során

     

    Megjegyzés: Az „Állapotesemény” mező értékeit a rendszer a kiválasztott „Nyomonkövetési esemény kategóriája” alapján tölti ki. Tekintse meg a következő táblázatot, ha többet szeretne megtudni a „Nyomonkövetési esemény kategóriája ” lehetőségről és az ahhoz tartozó „Állapotesemények” adatokról.

     

    Az eseménykategória állapota Állapotesemény

    Feladás

    • Csomag felvéve

    Tranzitban

    • Tranzitban

    Kézbesítés

    • Kézbesítve

    Rendkívüli események

    • Rendkívüli esemény a kézbesítés során

    Kézbesítés becsült ideje(hamarosan)

    • Kézbesítés becsült dátuma (EDD)
    • A kézbesítés becsült idejének időkerete (EDTW)

     

  3. Jelölje be az FedEx Developer Portal Licencszerződés (FDPLA) négyzetet a Licencszerződés aláírásához/elfogadásához.
  4. Kattintson a PUSH gombra a teszt eredményeinek megtekintéséhez.


Válasz:

A tesztkörnyezet válaszparaméterei a következők:

  • Szövegtörzs – A szövegtörzs tartalmazza a válaszparamétereket a Tesztwebhook URL-címe lapon belül a tesztkörnyezeti konzolban.
  • Állapot – Ez a szakasz a Teszteredmények lapon belül a feldolgozott kérés állapotáról tájékoztatja Önt.
  • Sikerről szóló üzenet mintája:
    Sikerült
    A Speciális integrált láthatóság nyomonkövetési eseményeinek tesztelési részleteit sikeresen kézbesítettük.

 

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

Sikeres művelet üzenetének mintája

Ha a tesztesemény kézbesítése meghiúsul, az ÁLLAPOT Hibaként jelenik meg a Teszteredmények lapon, a megfelelő hibakóddal és hibaüzenettel együtt.

Hibaüzenet mintája:
Hibakód:<<hibakód>>
A Speciális integrált láthatóság nyomonkövetési esemény részleteinek tesztelése sikertelen.

Hibaüzenet mintája

Ellenőrzési szabályok:

  • A Speciális integrált láthatóság URL-címének szabványos szintaktikai formátumban kell lennie.
  • A Speciális integrált láthatóság URL-je teszteléséhez szükséges egyetlen mező sem lehet üres.
  • Sikeres ellenőrzés esetén:
    • A FedEx küld egy kérést egy JSON-formátumú mintaeseménnyel együtt.
    • Megjegyzés: A Speciális integrált láthatóság rendeltetési URL-címének a 200-as (OK) választ kell adnia HTTP-állapotkódként a FedEx számára.
  • Sikertelen/Meghiúsult ellenőrzés esetén:
    • Ha a FedEx a 200-as (OK) választól eltérő választ kap, akkor a rendszer sikertelennek tekinti a Speciális integrált láthatóság rendeltetési URL-jének ellenőrzését.
    • A FedEx a Teszteredmények lapon belül jeleníti meg a hibakódot és a hibaüzenetet

Adattartalom-kalkulátor

Az Adattartalom-kalkulátor célja, hogy segítsen az előfizetőknek megbecsülni a webhook-tevékenységeken keresztül generált adatok mennyiségét. Áttekintést nyújt a napi adattartalom méretéről, a küldemények számáról és a nyomonkövetési eseményekről, így a felhasználók megalapozott döntéseket hozhatnak az adatfelhasználással és az integráció tervezésével kapcsolatban.

A kalkulátor használata

A felhasználók a következő paramétereket adhatják meg:

  • Küldemények száma
  • Események küldeményenként (alapértelmezett: 5)
  • Napi adattartalom mennyisége (automatikusan kiszámítva)

Ezen bemenetek alapján a kalkulátor dinamikusan megjeleníti a következőket:

  •  Összes nyomonkövetési események
  •  Napi adattartalom
  •  Becsült teljes adatméret

Tájékoztató megjegyzések:

  •  Az Események küldeményenként alapértelmezett értéke 5. Ez átlagosan 17–18 eseményen alapul küldeményenként, és a tipikusan 1–7 napos fuvarozási idővonalon alapul, a szolgáltatástípustól, a fuvarozótól és a rendeltetési helytől függően. Az átlagos fuvarozási idő 3 nap, amivel számolni kell. Megjegyzés: Ezt az értéket a felhasználó szerkesztheti.
  •  A napi adattartalom mennyisége a következőképpen számítható ki: Küldemények száma × Események küldeményenként (alapértelmezett: 5)
  •  A felhasználóknak csak a küldemények számát kell megadniuk, és a „KISZÁMÍTÁS” gombra kell kattintaniuk az eredmények generálásához. A többi érték vagy alapértelmezett, vagy automatikusan kerül kiszámításra.

Jogi nyilatkozat: A kalkulátor által megadott összes érték hozzávetőleges, és kizárólag tervezési célokat szolgál.

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