Sandbox Console
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:
- -> Á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.
- -> 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:
- Kattintson a Tesztwebhook URL-címe gombra.
- 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ó:
- Csomag felvéve
- Tranzitban
- Kézbesítve
- 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)
- Jelölje be az FedEx Developer Portal Licencszerződés (FDPLA) négyzetet a Licencszerződés aláírásához/elfogadásához.
- 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.
Status
Success
Test webhook tracking event details delivered successfully
Error
Test webhook tracking event details delivery failed
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.
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.
Response