Sandbox Console
Testarea webhookurilor
Puteți folosi funcția de testare a adrese URL pentru webhook ca să testați tipul de date de monitorizare returnate la adresa URL de destinație (server destinatar/ascultător). Aceasta ajută la validarea URL-ului și a datelor returnate anterior creării unui webhook Advanced Integrated Visibility.
Navigare:
În continuare, sunt prezentate modalitățile de navigare la consola mediului de testare pentru Testarea adresei URL pentru webhook:
- Proiectele mele (în panoul de navigare din stânga) -> fila Advanced Integrated Visibility -> butonul Testare adresă URL pentru webhook ->din Consolă mediu de testare, faceți clic pe Încercați acest webhook Advanced Integrated Visibility
- Catalog API (în panoul de navigare din stânga) -> căutați Advanced Integrated Visibility/faceți clic pe Advanced Integrated Visibility în cardul FILTRE -> Advanced Integrated Visibility:
- -> Prezentare generală -> butonul Documentație -> din Consolă mediu de testare, faceți clic pe Încercați acest webhook Advanced Integrated Visibility.
- -> Documente -> în Consola mediului de testare, faceți clic pe Încercați acest Advanced Integrated Visibility.
Pași:
În continuare, sunt prezentați pașii pentru utilizarea funcționalității de Testare adresă URL pentru webhook:
- Dați clic pe butonul Testare adresă URL pentru webhook.
- Introduceți următorii parametri de testare:
Numele câmpului Descriere URL destinație
Aceasta este adresa URL la care veți primi datele transmise ale evenimentului de monitorizare.
- Clientul ar trebui să indice o adresă URL de destinație, funcțională și validă.
- Adresa URL de destinație introdusă trebuie să fie în format sintactic standard (adresă URL https securizată).
Token de securitate
Folosit ca secret partajat pentru autentificarea și validarea răspunsului webhookului Advanced Integrated Visibility.
- Valoarea tokenului trebuie să aibă o lungime cuprinsă între 26 și 100 de caractere.
- Trebuie să conțină cel puțin 1 literă mare, 1 literă mică și 1 caracter numeric.
- Tokenul de securitate va fi folosit pentru a crea o semnătură de tip Cod de autentificare a mesajelor, bazată pe hash (HMAC), pentru validarea răspunsurilor.
Limbă sarcină
Selectați din lista derulantă limba preferată pentru traducerea datelor de monitorizare. În continuare, sunt prezentate 6 exemple de limbi disponibile:
- Engleză (Statele Unite)(implicit)
Tip urmărire
Selectați tipul de răspuns în care trebuie să fie primite datele de monitorizare.
- Răspuns detaliat pentru datele de monitorizare (tipul de răspuns constă în date de monitorizare securizate, care conțin întregul istoric al evenimentelor).(Implicit)
- Răspuns specific evenimentului pentru datele de monitorizare (tipul de răspuns constă în date de monitorizare securizate care conțin doar cele mai recente informații despre evenimente).(În curând)
Evenimente de monitorizare
Selectați o categorie de nivel superior pentru a primi notificări prin e-mail legate de evenimentele de expediere în ciclul de viață al coletului. Acestea sunt categoriile de nivel superior:
- Expediere
- În tranzit
- Livrare
- Excepții
- Livrare estimată
Eveniment de stare
Un eveniment de monitorizare din ciclul de viață al coletului. Selectați unul dintre evenimentele de monitorizare care urmează să fie primite. Acestea sunt 10 exemple de evenimente de stare disponibile:
- Preluat
- În tranzit
- Livrat
- Excepție privind livrarea
Notă: valorile câmpului „ Eveniment de stare” vor fi completate pe baza „Categoriei de eveniment de monitorizare”. Consultați tabelul următor pentru a afla mai multe despre „Categorie de eveniment de monitorizare” și „Evenimentele de stare” aferente.
Categorie eveniment stare Eveniment de stare Expediere
- Preluat
În tranzit
- În tranzit
Livrare
- Livrat
Excepții
- Excepție privind livrarea
Livrare estimată(În curând)
- Dată de livrare estimată (EDD)
- Intervalul de timp pentru livrare estimat (EDTW)
- Bifați caseta Acordul de licență FedEx Developer Portal (FDPLA) pentru a semna/accepta Acordul de licență.
- Dați clic pe butonul PUSH pentru a vedea rezultatele testării.
Răspuns:
Aceștia sunt parametrii de răspuns din mediul de testare:
- Cuprins – Cuprinsul conține parametrii de răspuns din fila Testare adresă URL pentru webhook din Consola mediului de testare.
- Stare – Această secțiune din fila Rezultatele testării vă indică starea solicitării aflată în curs de procesare.
Exemplu de mesaj de reușită::
Succes
Detaliile evenimentului de monitorizare Testare Advanced Integrated Visibility au fost livrate cu succes.
Status
Success
Test webhook tracking event details delivered successfully
Error
Test webhook tracking event details delivery failed
Dacă evenimentul de testare nu este livrat, STAREA va fi afișată ca Eroare în fila Rezultatele testării, laolaltă cu codul și mesajul de eroare aferent.
Exemplu de mesaj de eroare:
Cod de eroare:<<cod eroare>>
Livrarea detaliilor evenimentului de monitorizare Testare Advanced Integrated Visibility a eșuat.
Reguli de validare:
- URL-ul Advanced Integrated Visibility trebuie să fie în format sintactic standardizat.
- Toate câmpurile obligatorii pentru testarea unui URL Advanced Integrated Visibility trebuie să fie completate.
- Pentru validarea reușită:
- FedEx va trimite o solicitare cu un exemplu de eveniment JSON. Notă: URL-ul Advanced Integrated Visibility trebuie să răspundă cu 200 (OK) drept cod de stare HTTP către FedEx.
- În cazul unei validări nereușite/eșuate:
- În cazul în care FedEx primește orice alt răspuns decât 200 (OK), validarea URL-ului Advanced Integrated Visibility va fi considerată ca fiind eșuat.
- FedEx va afișa codul și mesajul de eroare în fila Rezultatele testării.
Calculator pentru date transmise
Calculatorul de date transmise este conceput pentru a ajuta abonații să estimeze volumul de date generat prin activitatea webhook. Oferă vizibilitate asupra dimensiunilor zilnice ale sarcinilor utile, a numărului de expedieri și a evenimentelor de urmărire — ajutând utilizatorii să ia decizii informate cu privire la utilizarea datelor și la planificarea integrării.
Folosirea calculatorului
Utilizatorii pot introduce următorii parametri:
- Numărul de expedieri
- Evenimente per expediere (implicit: 5)
- Volumul zilnic al datelor transmise (calculat automat)
Pe baza acestor date de intrare, calculatorul afișează dinamic:
- Evenimente totale de urmărire
- Date transmise zilnic
- Dimensiunea totală estimată a datelor
Note de informare:
- Numărul de evenimente per expediere este setat implicit la 5. Aceasta se bazează pe o medie de 17-18 evenimente per expediere și pe termene de livrare tipice de 1-7 zile, în funcție de tipul de serviciu, transportator și destinație. Se presupune un timp mediu de livrare de 3 zile. Notă: această valoare poate fi modificată de către utilizator.
- Volumul zilnic al datelor transmise este calculat astfel: număr de expedieri × evenimente per expediere (implicit: 5)
- Utilizatorii trebuie să introducă doar numărul de expedieri și să dea clic pe „CALCULARE” pentru a genera rezultate. Celelalte valori sunt fie implicite, fie calculate automat.
Declinarea responsabilității: toate valorile furnizate de calculator sunt aproximative și sunt destinate exclusiv planificării.
Response