Fedex Logo

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:
    1. -> Prezentare generală -> butonul Documentație -> din Consolă mediu de testare, faceți clic pe Încercați acest webhook Advanced Integrated Visibility.
    2. -> 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:

  1. Dați clic pe butonul Testare adresă URL pentru webhook.
  2. 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:

    1. Preluat
    2. În tranzit
    3. Livrat
    4. 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)

     

  3. Bifați caseta Acordul de licență FedEx Developer Portal (FDPLA) pentru a semna/accepta Acordul de licență.
  4. 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.

 

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

Exemplu de mesaj privind reușita

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.

Exemplu de mesaj de eroare

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.

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