Fedex Logo

WEBHOOK
LÉTREHOZÁSA WEBHOOKOK KEZELÉSE

Üzleti szabályok és ellenőrzési folyamat


  • Egyazon fuvarozási ügyfélszám nem használható több Speciális integrált láthatóságban.
  • Az ügyfél által létrehozott rendeltetési URL-címnek/végpontnak a következőknek kell eleget tennie:
    • HTTPs-kiszolgáló legyen.
    • Válaszoljon a POST-kérésre, és elemezze szintaktikailag a JSON-adattartalmat.
    • Karakterkorlátozás: 200 karakter
    • Az URL-címe le lesz tiltva, ha a következőket tartalmazza:
      • RFC1918 IP-tartomány
      • fedex.com vagy bármelyik aldomainje
      • Az URL-ben lévő IP-címek (beleértve a következőket: localhost, 127.0.0.1)

 

  • Speciális integrált láthatóság: Kizárólag a TLS (SSL) 1.2 vagy magasabb protokollverziókat használó HTTPS-kapcsolatok támogatottak, amelyek egy érvényes hitelesítésszolgáltató (CA) tanúsítványával vannak konfigurálva. Az alábbi IP-címek szerepelhetnek az engedélyezőlistán, így megszakítás nélkül kapja a FedEx kiszolgálóinak frissítéseit:
    Prod

         Az ügyfelek engedélyezőlistára tehetik: „nat.fxconnect.eastus2.heap-prod.fedex.io”

         "20.65.16.22/31" CIDR használata
  • Előfordulhat, hogy az ügyfelek a nyomonkövetési eseményfrissítéseket nem a megfelelő sorrendben kapják meg, és a helyes sorrend megállapításához meg kell tekinteniük a beolvasási esemény időbélyegzőjét.
  • Fiók(ok) törlése a FedEx Developer Portálon:
    • A felhasználó/ügyfél nem törölheti az ügyfélszámo(ka)t az alábbi esetekben:
      1. Ha az aktív Speciális integrált láthatósághoz van társítva.
      2. Ha az ügyfélszám elérhető, vagy azt projekthez rendelték hozzá, illetve
      3. Ha ez az egyetlen ügyfélszám egy projektben/Speciális integrált láthatóság.
        Megjegyzés: A felhasználónak/ügyfélnek először el kell távolítania az ügyfélszámot a projektből/Speciális integrált láthatóságból, majd törölnie kell azt a szervezetből.
    • A felhasználó/ügyfél törölheti az ügyfélszámo(ka)t az alábbi esetekben:
      1. Az ügyfélszámnak ugyanahhoz a szervezethez kell tartoznia.
      2. A felhasználónak/ügyfélnek rendszergazdának kell lennie ahhoz, hogy ügyfélszámokat törölhessen a szervezetből.

Gyakori korlátozások

  • A szolgáltató vállalatok – A FedEx Express®, FedEx Ground® és FedEx Ground® Economy (korábbi nevén FedEx SmartPost®) – 9 számjegyből álló ügyfélszámaihoz kapcsolódó valamennyi ügyfélküldeményre a rendeltetési helytől vagy a küldeményfeladási helytől függetlenül (bejövő, kimenő, nemzetközi, belföldi stb.) vonatkozik.
  • A Speciális integrált láthatóság webhook csak a 9 számjegyű vállalati/csomagengedéllyel rendelkező ügyfélszámokat támogatja. A vállalati ügyfélszámok lehetővé teszik az összes FedEx szolgáltató vállalathoz kapcsolódó küldemények létrehozását, beleértve a FedEx Express és a FedEx Ground szolgáltatásokat is.

    • Megjegyzés: A 9 számjegyű, csak LTL-szállítmány feladását engedélyező ügyfélszámok nem támogatottak; ha ilyen ügyfélszámot szeretne hozzáadni, akkor forduljon az ügyféltámogatáshoz az LTL-ügyfélszám vállalati ügyfélszámra történő portolása érdekében.
  • Az ügyfeleknek kell kezelniük a saját részükre beérkezett küldemények nyomonkövetési eseményeit.
  • Automatikus e-mail-értesítéseket küldünk minden olyan esetben, amikor bármilyen tevékenység (mentve/sikertelen/ létrehozás/frissítés/visszavonás/törlés) történik azon Speciális integrált láthatóság webhook kapcsán, amelyre előfizetett.
  • Fordítások:
    • A nyomonkövetési adattartalom fordítása 41 nyelv (területi beállítás) esetén támogatott.(Hamarosan)
      Kattintson ide a támogatott nyelvek listájának megtekintéséhez.
    • Jelenleg a nyomonkövetési adattartalom fordítása angol nyelven (Egyesült Államok) támogatott.
    • Az e-mailes értesítések fordítása csak az egyesült államokbeli régiók által támogatott nyelveken érhető el. (Helyszíni beállítás: en-US, es-US)

 


Felhasználói szerepkörök a FedEx Developer Portalon:


Az FedEx Developer Portalon belül a konfigurált szerepkörtől függően meghatározott funkciók hajthatók végre.
Ha többet szeretne megtudni a FedEx Developer Portalról, tekintse meg a Szervezetadminisztrációs útmutatót.

Speciális integrált láthatóság Ellenőrzési folyamat

Mi az a MAC/HMAC, és hogyan használják az érvényesítési folyamat során?

Az üzenethitelesítési kód (MAC) egy titkos kulcson alapuló módszert biztosít a megbízhatatlan adathordozón továbbított vagy tárolt információ integritásának ellenőrzésére. A MAC-eket általában két olyan fél között használják, akik megosztanak egy titkos kulcsot a két fél között továbbított információk hitelesítésére.

A kriptográfiai kivonatolási függvényeken alapuló MAC-mechanizmust HMAC-nek nevezik. A HMAC bármilyen kriptográfiai kivonatoló függvénnyel, például a SHA256-tal is használható egy titkos megosztott kulccsal kombinálva. A HMAC értékét az RFC 2104 határozza meg. A FedEx Speciális integrált láthatóság webhook a HMAC SHA256-ot fogja használni.

SHA256 (biztonsági token + adattartalom) = Base64 kódolású fdx-aláírás az adattartalom részeként Fejléc

Példa (a pszeudokód-részletre a HMAC SHA256-os kivonatolás illusztrálására):

  • Először inicializálja a MAC-et a HmacSHA256-algoritmus és a biztonsági token, mint titkos kulcs segítségével.
  • Ezután fejezze be a MAC-műveletet a FedEx által küldött kérés adattartalmának hex-kódolásával.
  • Ennek a végső kivonatnak meg kell egyeznie a FedEx által küldött PUSH-értesítésben szereplő fdx-signature fejléc értékével.

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

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

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

Megjegyzés: A használt titkos kulcs az a biztonságos token, amelyet a Speciális integrált láthatóság beállításakor vagy a Speciális integrált láthatóság URL-címének tesztelésekor ad meg.

 

Késleltetési számítás

 

Az esemény létrehozási időpontja azt jelzi, hogy egy esemény ténylegesen mikor történt a hálózatban.
Amíg az eseményt nem rögzítik a rendszerben (ezt az Üzenet létrehozásának időbélyegzője jelzi), sem a webhookok, sem más rendszerek nem tudják feldolgozni vagy kézbesíteni azt.

Javaslat

Az ügyfeleknek az Üzenet létrehozásának időbélyegzője lehetőséget kell használniuk a késleltetés mérésére, mivel ez tükrözi legjobban azt, hogy az esemény mikor vált elérhetővé a digitális rendszerek számára. Ez az időbélyeg van leginkább összhangban a FedEx digitális frissítéseinek időzítésével, és jellemzően gyorsabb – vagy szorosan összhangban van – a fedex.com oldalon látható frissítésekkel.

 

Ellenőrzési szabályok: 

  • A Speciális integrált láthatóság webhook nevének egyedinek kell lennie.
  • A Speciális integrált láthatóság webhook rendeltetési URL-címének szabványos szintaktikai formátumban kell lennie.
  • Egy Speciális integrált láthatóság webhook létrehozásához szükséges összes mező nem lehet üres.
  • A Speciális integrált láthatóság webhook  létrehozásához legalább egy elérhető FedEx fuvarozási ügyfélszámot kell társítani.
  • Sikeres ellenőrzés esetén:
    • Ha a Speciális integrált láthatóság webhook létrehozása sikeres, az ügyfél egy megerősítő üzenetet kap erről.

      Visszaigazoló üzenet mintája: <<Speciális integrált láthatóság webhook neve>> sikeresen létrehozva. A módosítások életbe lépése akár 10 percet is igénybe vehet.

  • Sikertelen/meghiúsult ellenőrzés esetén:
    • Ha a FedEx a 200-as (OK) vagy 202-es (OK) választól eltérő választ kap, akkor a rendszer sikertelennek tekinti a Speciális integrált láthatóság webhook rendeltetési URL-jének érvényesítését.

Minta üzleti szabályok és ellenőrzési folyamat


  • Egyazon fuvarozási ügyfélszám nem használható több Speciális integrált láthatóságban.
  • Az ügyfél által létrehozott rendeltetési URL-címnek/végpontnak a következőknek kell eleget tennie:
    • HTTPs-kiszolgáló legyen.
    • Válaszoljon a POST-kérésre, és elemezze szintaktikailag a JSON-adattartalmat.
    • Karakterkorlátozás: 200 karakter
    • Az URL-címe le lesz tiltva, ha a következőket tartalmazza:
      • RFC1918 IP-tartomány
      • fedex.com vagy bármelyik aldomainje
      • Az URL-ben lévő IP-címek (beleértve a következőket: localhost, 127.0.0.1)

 

  • Speciális integrált láthatóság: Kizárólag a TLS (SSL) 1.2 vagy magasabb protokollverziókat használó HTTPS-kapcsolatok támogatottak, amelyek egy érvényes hitelesítésszolgáltató (CA) tanúsítványával vannak konfigurálva. Az alábbi IP-címek szerepelhetnek az engedélyezőlistán, így megszakítás nélkül kapja a FedEx kiszolgálóinak frissítéseit:
    Prod

         Az ügyfelek engedélyezőlistára tehetik: „nat.fxconnect.eastus2.heap-prod.fedex.io”

         "20.65.16.22/31" CIDR használata
  • Előfordulhat, hogy az ügyfelek a nyomonkövetési eseményfrissítéseket nem a megfelelő sorrendben kapják meg, és a helyes sorrend megállapításához meg kell tekinteniük a beolvasási esemény időbélyegzőjét.
  • Fiók(ok) törlése a FedEx Developer Portálon:
    • A felhasználó/ügyfél nem törölheti az ügyfélszámo(ka)t az alábbi esetekben:
      1. Ha az aktív Speciális integrált láthatósághoz van társítva.
      2. Ha az ügyfélszám elérhető, vagy azt projekthez rendelték hozzá, illetve
      3. Ha ez az egyetlen ügyfélszám egy projektben/Speciális integrált láthatóság.
        Megjegyzés: A felhasználónak/ügyfélnek először el kell távolítania az ügyfélszámot a projektből/Speciális integrált láthatóságból, majd törölnie kell azt a szervezetből.
    • A felhasználó/ügyfél törölheti az ügyfélszámo(ka)t az alábbi esetekben:
      1. Az ügyfélszámnak ugyanahhoz a szervezethez kell tartoznia.
      2. A felhasználónak/ügyfélnek rendszergazdának kell lennie ahhoz, hogy ügyfélszámokat törölhessen a szervezetből.
CLOSE

Response

Copy