Fedex Logo

OPRET EN
WEBHOOK ADMINISTRER WEBHOOKS

Forretningsregler og valideringsproces


  • Et enkelt forsendelseskontonummer kan ikke bruges i flere Advanced Integrated Visibility.
  • Destinations-URL'en/slutpunktet oprettet af kunden skal:
    • være af HTTPs host.
    • Svare på POST-anmodninger og fortolke JSON-data.
    • Begrænsning på 200 tegn
    • Din URL vil blive blokeret, hvis den inkluderer:
      • RFC1918 IP-plads
      • fedex.com eller et hvilket som helst af dets underdomæner
      • IP-adresser i URL'en (herunder localhost, 127.0.0.1)

 

  • Advanced Integrated Visibility-sikkerhed: Der understøttes kun HTTPS-forbindelser, der bruger protokolversion TLS (SSL) 1.2 eller højere, som er konfigureret med et certifikat fra en gyldig certificeringsmyndighed (CA). Hvidlist nedenstående IP-adresser for at modtage opdateringer fra FedEx-servere uden forstyrrelser:
    Prod

       Kunder kan hvidliste: "nat.fxconnect.eastus2.heap-prod.fedex.io"

       Bruge CIDR "20.65.16.22/31"
  • Kunder kan nogle gange modtage opdateringer af tracking-hændelser i forkert rækkefølge og skal se på tidsstemplet for scanningshændelsen for den korrekte rækkefølge.
  • Sådan slettes en konto i FedEx Developer Portal:
    • Bruger/kunde kan ikke slette konto(/konti):
      1. Hvis den er tilknyttet en aktiv Advanced Integrated Visibility.
      2. hvis kontoen er tilgængelige eller tilknyttet et projekt, og
      3. Hvis det er den eneste konto i et projekt/Advanced Integrated Visibility.
        Bemærk: Bruger/kunde skal fjerne kontoen fra projektet/Advanced Integrated Visibility først, og så slette den fra organisationen.
    • Bruger/kunde kan slette konto(/konti):
      1. Kontoen skal tilhøre samme organisation.
      2. Bruger/kunde skal være administrator for at slette konti fra organisationen.

Almindelige begrænsninger

  • Alle kundeforsendelser, der er tilknyttet 9-cifrede FedEx-kontonumrene på driftsselskaber – FedEx Express®, FedEx Ground® og FedEx Ground® Economy (tidligere FedEx SmartPost®) er omfattet uanset destination eller oprindelse (indgående, udgående, international , indenlandsk osv.).
  • Advanced Integrated Visibility Webhook understøtter kun 9-cifrede virksomheds-/pakkeaktiverede konti. Virksomhedskonti giver mulighed for oprettelse af forsendelser tilknyttet alle FedEx-driftsselskaber herunder FedEx Express og FedEx Ground.

    • Bemærk: 9-cifrede LTL Freight only-konti understøttes ikke. Hvis du vil tilføje en LTL Freight-konto, skal du kontakte kundeservice for at overføre en LTL-konto til en virksomhedskonto.
  • Kunder skal administrere rækkefølgen af forsendelsestrackinghændelser, de modtager.
  • Automatiske e-mailnotifikationer sendes, når der er aktivitet (Gemt/Mislykket/Opret/Opdater/Annuller/Slet) på den abonnerede Advanced Integrated Visibility Webhook.
  • Oversættelser:
    • Oversættelse af trackingdata understøttes på 41 sprog (landeindstillinger).(Kommer snart)
      Klik her for at se listen over understøttede sprog.
    • Oversættelse af trackingdata understøttes i øjeblikket på engelsk (USA).
    • Oversættelse af e-mailnotifikationer er kun tilgængelig for sprog understøttet af amerikanske regioner. (Landeindstillinger: en-US, es-US)

 


Brugerroller i FedEx Developer Portal:


I FedEx Developer Portal kan du udføre specifikke funktioner baseret på den konfigurerede rolle.
For at få mere at vide om FedEx Developer Portal kan du se Vejledning til organisationsadministration.

Valideringsproces for Advanced Integrated Visibility

Hvad er MAC/HMAC, og hvordan bruges det i bekræftelsesprocessen?

En meddelelsesgodkendelseskode (MAC) giver mulighed for at kontrollere integriteten af oplysninger, der sendes over eller lagres på et upålideligt medie, baseret på en hemmelig nøgle. MAC'er bruges typisk mellem to parter, der deler en hemmelig nøgle til at bekræfte oplysninger, der overføres mellem de to parter.

En MAC-mekanisme, der er baseret på kryptografiske hashfunktioner, kaldes HMAC. HMAC kan bruges med enhver kryptografisk hashfunktion, fx. SHA256, i kombination med en hemmelig delt nøgle. HMAC er specificeret i RFC 2104. FedEx Advanced Integrated Visibility Webhook bruger HMAC SHA256.

SHA256 (sikkerhedstoken og payload) = Base 64-kodet fdx-signatur som del af datasidehoved

Eksempel (på et pseudokodestykke til at illustrere en HMAC SHA256 hashing):

  • Start først MAC ved hjælp af HmacSHA256-algoritmen og sikkerhedstokenet som den hemmelige nøgle.
  • Afslut derefter MAC-operationen ved at hex-kode anmodningens data sendt af FedEx.
  • Denne sidste hash skal matche værdien af sidehoved fdx-signaturen i push-meddelelsen sendt af FedEx.

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

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

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

Bemærk: Den hemmelige nøgle, der bruges, er det sikre token, som du leverer ved opsættelsen af en Advanced Integrated Visibility eller ved test af Advanced Integrated Visibility-URL'en.

 

Beregning af latenstid

 

Hændelsesoprettelsestidspunktet angiver, hvornår en hændelse faktisk fandt sted i netværket.
Indtil hændelsen er logget i systemet (angivet af tidsstempel for meddelelsesoprettelse), kan hverken webhooks eller andre systemer behandle eller levere den.

Anbefaling

Kunder bør bruge tidsstempel for meddelelsesoprettelse til at måle latenstid, da det bedst viser, hvornår hændelsen blev tilgængelig i digitale systemer. Dette tidsstempel ligger tættest på tidspunktet for FedEx' digitale opdateringer og er typisk hurtigere end – eller tæt på – de opdateringer, der er synlige på fedex.com.

 

Valideringsregler: 

  • Advanced Integrated Visibility Webhook-navnet skal være unikt.
  • Destinations-URL'en for Advanced Integrated Visibility Webhook skal være i standardiseret syntaktisk format.
  • Ingen af de påkrævede felter til oprettelse af Advanced Integrated Visibility Webhook må være tomme.
  • Mindst ét tilgængeligt FedEx-forsendelseskundenummer skal være tilknyttet for at oprette en Advanced Integrated Visibility Webhook.
  • For vellykket bekræftelse:
    • Når en Advanced Integrated Visibility Webhook er oprettet, modtager kunden en bekræftelsesmeddelelse.

      Eksempel på bekræftelsesmeddelelse: <<Advanced Integrated Visibility Webhook-navn>> er oprettet. Det kan tage op til 10 minutter, før ændringerne træder i kraft.

  • For mislykket bekræftelse:
    • Hvis FedEx modtager andre svar end 200 (OK) eller 202 (Accepteret), betragtes bekræftelsen af destinations-URL'en for Advanced Integrated Visibility Webhook som mislykket.

Eksempel på forretningsregler og valideringsproces


  • Et enkelt forsendelseskontonummer kan ikke bruges i flere Advanced Integrated Visibility.
  • Destinations-URL'en/slutpunktet oprettet af kunden skal:
    • være af HTTPs host.
    • Svare på POST-anmodninger og fortolke JSON-data.
    • Begrænsning på 200 tegn
    • Din URL vil blive blokeret, hvis den inkluderer:
      • RFC1918 IP-plads
      • fedex.com eller et hvilket som helst af dets underdomæner
      • IP-adresser i URL'en (herunder localhost, 127.0.0.1)

 

  • Advanced Integrated Visibility-sikkerhed: Der understøttes kun HTTPS-forbindelser, der bruger protokolversion TLS (SSL) 1.2 eller højere, som er konfigureret med et certifikat fra en gyldig certificeringsmyndighed (CA). Hvidlist nedenstående IP-adresser for at modtage opdateringer fra FedEx-servere uden forstyrrelser:
    Prod

       Kunder kan hvidliste: "nat.fxconnect.eastus2.heap-prod.fedex.io"

       Bruge CIDR "20.65.16.22/31"
  • Kunder kan nogle gange modtage opdateringer af tracking-hændelser i forkert rækkefølge og skal se på tidsstemplet for scanningshændelsen for den korrekte rækkefølge.
  • Sådan slettes en konto i FedEx Developer Portal:
    • Bruger/kunde kan ikke slette konto(/konti):
      1. Hvis den er tilknyttet en aktiv Advanced Integrated Visibility.
      2. hvis kontoen er tilgængelige eller tilknyttet et projekt, og
      3. Hvis det er den eneste konto i et projekt/Advanced Integrated Visibility.
        Bemærk: Bruger/kunde skal fjerne kontoen fra projektet/Advanced Integrated Visibility først, og så slette den fra organisationen.
    • Bruger/kunde kan slette konto(/konti):
      1. Kontoen skal tilhøre samme organisation.
      2. Bruger/kunde skal være administrator for at slette konti fra organisationen.
CLOSE

Response

Copy