Fedex Logo

WEBHOOK
AANMAKEN WEBHOOKS BEHEREN

Bedrijfsregels en validatieproces


  • Hetzelfde verzendaccountnummer kan niet worden gebruikt voor meerdere Geavanceerde geïntegreerde zichtbaarheid.
  • De bestemmings-URL/het eindpunt gecreëerd door de klant moet:
    • Een HTTPS-host zijn.
    • Reageren op POST-verzoeken en JSON-laadvermogens parseren.
    • Tekenlimiet van 200 tekens
    • Uw URL wordt geblokkeerd als deze het volgende bevat:
      • RFC1918 IP-ruimte
      • fedex.com of een van de bijbehorende subdomeinen
      • IP-adressen in de URL (inclusief localhost, 127.0.0.1)

 

  • Beveiliging Geavanceerde geïntegreerde zichtbaarheid: alleen HTTPS-verbindingen die TLS (SSL) 1.2 of een nieuwere protocolversie gebruiken die is geconfigureerd met een certificaat van een geldige certificeringsinstantie (CA) worden ondersteund. Sta de onderstaande IP-adressen toe om zonder onderbrekingen updates te ontvangen van FedEx-servers:
    Prod

         Klanten kunnen toestaan: "nat.fxconnect.eastus2.heap-prod.fedex.io"

         Door gebruik te maken van CIDR "20.65.16.22/31"
  • Het kan voorkomen dat klanten de trackinggebeurtenisupdates niet in de juiste volgorde ontvangen. Ze moeten dan naar de tijdstempel van de scanactiviteit kijken voor de juiste volgorde.
  • Account(s) verwijderen in FedEx Developer Portal:
    • Gebruiker/klant kan geen account(s) verwijderen:
      1. Als het is gekoppeld met actieve Geavanceerde geïntegreerde zichtbaarheid.
      2. Als het account beschikbaar of aan een project gekoppeld is, en
      3. Als het het enige account is in een project/Geavanceerde geïntegreerde zichtbaarheid.
        Opmerking: de gebruiker/klant moet het account eerst uit het project/de Geavanceerde geïntegreerde zichtbaarheid verwijderen en vervolgens uit de organisatie.
    • Gebruiker/klant kan account(s) verwijderen:
      1. Het account moet tot dezelfde organisatie behoren.
      2. De gebruiker/klant moet beheerder zijn om accounts te verwijderen uit de organisatie.

Veelvoorkomende beperkingen

  • Alle klantzendingen die zijn gekoppeld aan de 9-cijferige accountnummers van de werkmaatschappijen FedEx Express®, FedEx Ground® en FedEx Ground® Economy (voorheen bekend als FedEx SmartPost®) vallen binnen het bereik, ongeacht de bestemming of herkomst (import, uitgaand, internationaal, binnenlands, enz.).
  • Webhook Geavanceerde geïntegreerde zichtbaarheid ondersteunt alleen 9-cijferige zakelijke accounts/accounts waarvoor pakketten zijn ingeschakeld. Met zakelijke accounts kunnen zendingen worden aangemaakt die zijn gekoppeld aan alle FedEx-werkmaatschappijen, inclusief FedEx Express en FedEx Ground.

    • Opmerking: 9-cijferige alleen LTL Freight-accounts worden niet ondersteund. Als u een LTL Freight-account wilt toevoegen, moet u contact opnemen met de klantenservice om een LTL-account over te zetten naar een zakelijk account.
  • Klanten moeten zelf de volgorde van de ontvangen trackinggebeurtenissen voor hun zending beheren.
  • Er worden automatische e-mailmeldingen verzonden bij elke activiteit (opslaan/mislukt/aanmaken/bijwerken/annuleren/verwijderen) voor de geabonneerde Geavanceerde geïntegreerde zichtbaarheid-webhook.
  • Vertalingen:
    • Vertalingen van tracking-laadvermogens worden ondersteund in 41 talen (taalvarianten).(binnenkort)
      Klik hier om de lijst met ondersteunde talen te bekijken.
    • Vertaling van tracking-laadvermogens wordt momenteel alleen ondersteund voor Engels (Verenigde Staten).
    • De vertalingen van e-mailmeldingen zijn alleen beschikbaar voor talen die worden ondersteund in de VS. (Taalvarianten: en-US, es-US)

 


Gebruikersrollen binnen FedEx Developer Portal:


Binnen de FedEx Developer Portal kunt u specifieke functies uitvoeren op basis van de geconfigureerde rol.
Raadpleeg de Gids voor organisatiebeheer voor meer informatie over FedEx Developer Portal.

Validatieproces voor Geavanceerde geïntegreerde zichtbaarheid

Wat is een MAC/HMAC en hoe wordt dit gebruikt in het validatieproces?

Met een berichtauthenticatiecode (MAC) kan de integriteit van informatie worden geverifieerd die wordt verzonden via een onbetrouwbaar kanaal of is opgeslagen in een onveilige omgeving. Dit gebeurt op basis van een geheime sleutel. Doorgaans worden MAC's gebruikt tussen twee partijen die een geheime sleutel delen om informatie te valideren die tussen deze twee partijen wordt verzonden.

Een MAC-mechanisme dat gebruikmaakt van cryptografische hash-functies staat bekend als HMAC. HMAC kan worden gebruikt met elke cryptografische hash-functie, zoals SHA256, in combinatie met een gedeelde geheime sleutel. HMAC is gespecificeerd in RFC 2104. De FedEx-webhook Geavanceerde geïntegreerde zichtbaarheid maakt gebruik van HMAC SHA256.

SHA256( veiligheidstoken + laadvermogen) =  met Base 64 gecodeerde fdx-handtekening als onderdeel van koptekst laadvermogen

Voorbeeld (van een pseudocodefragment van HMAC SHA256-hashing):

  • Begin met het initialiseren van de MAC met het HMAC SHA256-algoritme en gebruik de beveiligingstoken als de geheime sleutel.
  • Rond vervolgens de MAC-handeling af door het laadvermogen voor aanvragen verzonden door FedEx om te zetten naar hexadecimale codering.
  • De uiteindelijke hash-waarde moet overeenkomen met de waarde van de koptekst fdx-handtekening in het PUSH-bericht dat werd verzonden door FedEx.

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

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

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

Opmerking: de gebruikte geheime sleutel is de beveiligingstoken die door u wordt verstrekt bij het instellen van de Geavanceerde geïntegreerde zichtbaarheid of bij het testen van de Geavanceerde geïntegreerde zichtbaarheid-URL.

 

Latentieberekening

 

De Aanmaaktijd gebeurtenis geeft aan wanneer een gebeurtenis daadwerkelijk heeft plaatsgevonden in het netwerk.
Totdat de gebeurtenis is geregistreerd in het systeem (aangegeven door het Bericht Tijdstempel aanmaken), kunnen noch webhooks noch andere systemen het verwerken of leveren.

Aanbeveling

Klanten moeten het Bericht Tijdstempel aanmaken gebruiken om latentie te meten, omdat dit het beste weergeeft wanneer de gebeurtenis beschikbaar werd voor digitale systemen. Dit tijdstempel komt het meest overeen met de timing van de digitale updates van FedEx en is doorgaans sneller dan –of vrijwel gelijk aan– de updates die zichtbaar zijn op fedex.com.

 

Validatieregels: 

  • De naam van de webhook Geavanceerde geïntegreerde zichtbaarheid  moet uniek zijn.
  • De bestemmings-URL voor de webhook Geavanceerde geïntegreerde zichtbaarheid moet de gestandaardiseerde syntactische indeling hebben.
  • Alle vereiste velden voor het maken van een Geavanceerde geïntegreerde zichtbaarheid-webhook mogen niet leeg zijn.
  • Er moet ten minste één beschikbaar FedEx-verzendaccountnummer worden gekoppeld om een Geavanceerde geïntegreerde zichtbaarheid-webhook aan te maken.
  • Voor geslaagde validatie:
    • De klant ontvangt een bericht ter bevestiging als een Geavanceerde geïntegreerde zichtbaarheid-webhook is aangemaakt.

      Voorbeeld van een bevestigingsbericht: <<Geavanceerde geïntegreerde zichtbaarheid-webhooknaam>> is gemaakt. Het kan maximaal 10 minuten duren voordat wijzigingen zijn verwerkt.

  • Voor niet-geslaagde/mislukte validatie:
    • Als FedEx een andere reactie ontvangt dan 200 (OK) of 202 (Geaccepteerd), wordt de validatie van de bestemmings-URL van de Geavanceerde geïntegreerde zichtbaarheid-webhook als mislukt beschouwd.

Voorbeeld van bedrijfsregels en validatieproces


  • Hetzelfde verzendaccountnummer kan niet worden gebruikt voor meerdere Geavanceerde geïntegreerde zichtbaarheid.
  • De bestemmings-URL/het eindpunt gecreëerd door de klant moet:
    • Een HTTPS-host zijn.
    • Reageren op POST-verzoeken en JSON-laadvermogens parseren.
    • Tekenlimiet van 200 tekens
    • Uw URL wordt geblokkeerd als deze het volgende bevat:
      • RFC1918 IP-ruimte
      • fedex.com of een van de bijbehorende subdomeinen
      • IP-adressen in de URL (inclusief localhost, 127.0.0.1)

 

  • Beveiliging Geavanceerde geïntegreerde zichtbaarheid: alleen HTTPS-verbindingen die TLS (SSL) 1.2 of een nieuwere protocolversie gebruiken die is geconfigureerd met een certificaat van een geldige certificeringsinstantie (CA) worden ondersteund. Sta de onderstaande IP-adressen toe om zonder onderbrekingen updates te ontvangen van FedEx-servers:
    Prod

         Klanten kunnen toestaan: "nat.fxconnect.eastus2.heap-prod.fedex.io"

         Door gebruik te maken van CIDR "20.65.16.22/31"
  • Het kan voorkomen dat klanten de trackinggebeurtenisupdates niet in de juiste volgorde ontvangen. Ze moeten dan naar de tijdstempel van de scanactiviteit kijken voor de juiste volgorde.
  • Account(s) verwijderen in FedEx Developer Portal:
    • Gebruiker/klant kan geen account(s) verwijderen:
      1. Als het is gekoppeld met actieve Geavanceerde geïntegreerde zichtbaarheid.
      2. Als het account beschikbaar of aan een project gekoppeld is, en
      3. Als het het enige account is in een project/Geavanceerde geïntegreerde zichtbaarheid.
        Opmerking: de gebruiker/klant moet het account eerst uit het project/de Geavanceerde geïntegreerde zichtbaarheid verwijderen en vervolgens uit de organisatie.
    • Gebruiker/klant kan account(s) verwijderen:
      1. Het account moet tot dezelfde organisatie behoren.
      2. De gebruiker/klant moet beheerder zijn om accounts te verwijderen uit de organisatie.
CLOSE

Response

Copy