Fedex Logo

CREAȚI UN
WEBHOOK GESTIONARE WEBHOOKURI

Reguli pentru afaceri și procesul de validare


  • Un număr cont client de expediere nu poate fi folosit în mai multe webhookuri Advanced Integrated Visibility.
  • Adresa URL de destinație/punctul final creat de client trebuie să îndeplinească următoarele condiții:
    • Să fie gazda HTTPs.
    • Să răspundă la solicitările POST și să analizeze datele JSON transmise.
    • Limită de 200 de caractere
    • URL-ul dvs. va fi blocat dacă include:
      • Spațiul RFC1918 IP
      • Domeniul fedex.com sau oricare dintre subdomeniile acestuia
      • Adresele IP din URL ( inclusiv localhost, 127.0.0.1)

 

  • Securitate Advanced Integrated Visibility: sunt acceptate numai conexiuni HTTPS care utilizează TLS (SSL) 1.2 sau o versiune de protocol mai mare, configurată cu un certificat de la o autoritate de certificare (CA) validă. Treceți pe lista albă adresele IP de mai jos pentru a primi actualizări de la serverele FedEx fără întreruperi:
    Prod

         Clienții pot adăuga în lista albă: „nat.fxconnect.eastus2.heap-prod.fedex.io”

         Folosind CIDR „20.65.16.22/31”
  • Clienții pot primi uneori actualizări despre evenimentele de monitorizare într-o ordine incorectă și trebuie să consulte marca temporală a evenimentului de scanare pentru a stabili ordinea corectă.
  • Ștergerea conturilor din FedEx Developer Portal
    • Utilizatorul/Clientul nu poate șterge contul(conturile) de client:
      1. Dacă este asociat cu orice webhook Advanced Integrated Visibility activ.
      2. În cazul în care contul de client este disponibil sau asociat cu un proiect și
      3. Dacă este singurul cont dintr-un proiect/Advanced Integrated Visibility.
        Notă: utilizatorul/clientul trebuie mai întâi să elimine contul din proiect/Advanced Integrated Visibility și apoi să-l șteargă din organizație.
    • Utilizatorul/Clientul poate șterge contul(conturile) de client:
      1. Contul de client trebuie să aparțină de aceeași organizație.
      2. Utilizatorul/Clientul trebuie să dețină rolul de administrator pentru a putea șterge conturile de client din organizație.

Restricții frecvente

  • Toate expedierile clientului asociate cu numere de cont FedEx formate din 9 cifre ale companiilor operaționale - FedEx Express®, FedEx Ground® and FedEx Ground® Economy (denumit anterior FedEx SmartPost®) sunt incluse în sfera de aplicare, indiferent de destinație sau origine (import, export, internațional, național etc.).
  • Webhookul Advanced Integrated Visibility acceptă numai conturi formate din 9 cifre pentru întreprinderi/colete. Conturile de întreprindere permit crearea de expedieri asociate cu toate companiile operaționale FedEx, inclusiv FedEx Express și FedEx Ground.

    • Notă:: conturile LTL Freight formate din 9 cifre nu sunt acceptate; dacă doriți să adăugați contul de client LTL Freight, trebuie să contactați echipa de asistență clienți pentru a porta un cont LTL într-un cont de întreprindere.
  • Clienții trebuie să gestioneze ordinea evenimentelor de monitorizare a expedierilor, primite la ei.
  • Notificările automate prin e-mail sunt trimise ori de câte ori există o activitate (Salvată/Eșuată/Creare/Actualizare/Anulare/Ștergere) cu privire la webhookul Advanced Integrated Visibility.
  • Traduceri:
    • Traducerea datelor transmise privind monitorizarea se poate efectua în 41 de limbi (variabile locale).(în curând)
      Faceți clic aici pentru a vedea lista cu toate limbile acceptate.
    • În prezent, traducerea datelor transmise pentru monitorizare este acceptată în engleză (Statele Unite).
    • opțiunea de traducere a notificărilor prin e-mail este disponibilă doar pentru limbile acceptate în regiunile SUA. (Limbă: en-US, es-US)

 


Rolurile utilizatorilor FedEx Developer Portal:


În FedEx Developer Portal, puteți efectua anumite funcții pe baza rolului configurat.
Pentru a afla mai multe despre FedEx Developer Portal, consultați Ghidul privind administrarea organizației.

Procesul de validare a webhookului Advanced Integrated Visibility 

Ce reprezintă MAC/HMAC și cum se folosește în procesul de validare?

Un cod de autentificare a mesajelor (MAC) oferă o modalitate de a verifica integritatea informațiilor transmise sau stocate pe un mediu nesigur, pe baza unei chei secrete. În mod normal, codurile MAC sunt utilizate între două părți care partajează o cheie secretă pentru a valida informațiile transmise între cele două părți.

Un mecanism MAC care se bazează pe funcții criptografice de hash se numește HMAC. HMAC poate fi utilizat cu orice funcție criptografică de hash, de ex., SHA256, în combinație cu o cheie secretă partajată. HMAC este specificat în RFC 2104. Webhookul FedEx Advanced Integrated Visibility va utiliza HMAC SHA256.

SHA256 (token de securitate + date transmise) =semnătură fdx codificată în Base64, inclusă ca parte a antetului datelor transmise

Exemplu (al unui fragment de pseudo-cod pentru a ilustra codificarea prin hash HMAC SHA256):

  • Mai întâi, inițializați MAC folosind algoritmul HmacSHA256 și tokenul de securitate drept cheie secretă.
  • Apoi, finalizați operațiunea MAC prin codificarea în hexazecimal a datelor transmise în solicitarea trimisă de FedEx.
  • Acest hash final trebuie să corespundă cu valoarea antetului fedex-signature din mesajul PUSH trimis de FedEx.

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

return new String(Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

Notă: cheia secretă utilizată este tokenul securizat pe care-l veți furniza la configurarea Advanced Integrated Visibilitysau la testarea URL-ului .

 

Calcularea latenței

 

Ora de creare a evenimentului reprezintă momentul în care un eveniment a avut loc efectiv în rețea.
Până când evenimentul este înregistrat în sistem (indicat de marcajul temporal de creare a mesajului), nici webhookurile și nici alte sisteme nu îl pot procesa sau livra.

Recomandare

Clienții ar trebui să folosească marcajul temporal de creare a mesajului pentru a măsura latența, deoarece acesta reflectă cel mai bine momentul în care evenimentul a devenit disponibil pentru sistemele digitale. Acest marcaj temporal este cel mai apropiat de momentul actualizărilor digitale FedEx și, de regulă, este mai rapid decât – sau aliniat îndeaproape cu – actualizările vizibile pe fedex.com.

 

Reguli de validare: 

  • Numele webhookului Advanced Integrated Visibility trebuie să fie unic.
  • URL-ul de destinație al webhookului Advanced Integrated Visibility trebuie să fie în format sintactic standardizat.
  • Toate câmpurile obligatorii pentru testarea unui webhook Advanced Integrated Visibility trebuie să fie completate.
  • Pentru crearea unui webhook Advanced Integrated Visibility, trebuie asociat cel puțin un număr cont de expediere FedEx disponibil.
  • Pentru validarea reușită:
    • Când un webhook Advanced Integrated Visibility este creat cu succes, clientul va primi un mesaj de confirmare.

      Exemplu de mesaj de confirmare: <<Nume webhook Advanced Integrated Visibility>> a fost creat cu succes. Aplicarea modificărilor poate dura până la 10 minute.

  • În cazul unei validări nereușite/eșuate:
    • În cazul în care FedEx primește orice alt răspuns decât 200 (OK) sau 202 (Acceptat), validarea URL-ului de destinație al webhookului Advanced Integrated Visibility va fi considerată ca eșuată.

Reguli pentru afaceri și proces de validare (exemple)


  • Un număr cont client de expediere nu poate fi folosit în mai multe webhookuri Advanced Integrated Visibility.
  • Adresa URL de destinație/punctul final creat de client trebuie să îndeplinească următoarele condiții:
    • Să fie gazda HTTPs.
    • Să răspundă la solicitările POST și să analizeze datele JSON transmise.
    • Limită de 200 de caractere
    • URL-ul dvs. va fi blocat dacă include:
      • Spațiul RFC1918 IP
      • Domeniul fedex.com sau oricare dintre subdomeniile acestuia
      • Adresele IP din URL ( inclusiv localhost, 127.0.0.1)

 

  • Securitate Advanced Integrated Visibility: sunt acceptate numai conexiuni HTTPS care utilizează TLS (SSL) 1.2 sau o versiune de protocol mai mare, configurată cu un certificat de la o autoritate de certificare (CA) validă. Treceți pe lista albă adresele IP de mai jos pentru a primi actualizări de la serverele FedEx fără întreruperi:
    Prod

         Clienții pot adăuga în lista albă: „nat.fxconnect.eastus2.heap-prod.fedex.io”

         Folosind CIDR „20.65.16.22/31”
  • Clienții pot primi uneori actualizări despre evenimentele de monitorizare într-o ordine incorectă și trebuie să consulte marca temporală a evenimentului de scanare pentru a stabili ordinea corectă.
  • Ștergerea conturilor din FedEx Developer Portal
    • Utilizatorul/Clientul nu poate șterge contul(conturile) de client:
      1. Dacă este asociat cu orice webhook Advanced Integrated Visibility activ.
      2. În cazul în care contul de client este disponibil sau asociat cu un proiect și
      3. Dacă este singurul cont dintr-un proiect/Advanced Integrated Visibility.
        Notă: utilizatorul/clientul trebuie mai întâi să elimine contul din proiect/Advanced Integrated Visibility și apoi să-l șteargă din organizație.
    • Utilizatorul/Clientul poate șterge contul(conturile) de client:
      1. Contul de client trebuie să aparțină de aceeași organizație.
      2. Utilizatorul/Clientul trebuie să dețină rolul de administrator pentru a putea șterge conturile de client din organizație.
CLOSE

Response

Copy