Fedex Logo

SKAPA EN
WEBHOOK HANTERA WEBHOOKAR

Testa en webhook


Du kan använda funktionen Testa webhook-URL för att testa vilken typ av spårningsdata som returneras till destinations-URL:en (mottagar-/lyssnarserver). Det här hjälper till att validera URL:en och de data som returneras innan du skapar en Advanced Integrated Visibility-webhook.

Navigering:

Så här navigerar du till sandlådekonsolen Testa en webhook URL:

  • Mina projekt (i den vänstra navigeringspanelen) -> Advanced Integrated Visibility-fliken-> Testa en  webhook URL-knappen->i sandlådekonsolen, klicka på Testa det här Advanced Integrated Visibility
  • API-katalog (i den vänstra menyn) -> sök efter Advanced Integrated Visibility/klicka på Advanced Integrated Visibility i FILTER -> kortet Advanced Integrated Visibility:
    1. -> Översikt -> knappen Dokumentation -> klicka på Testa det här Advanced Integrated Visibility-projektet i sandlådekonsolen
    2. -> Dokument -> klicka på Testa det här Advanced Integrated Visibility-projektet i sandlådekonsolen

Steg:

Följande steg är för att använda funktionen Testa en webhook-URL:

  1. Klicka på knappen Testa webhook- URL.
  2. Ange följande testparametrar:
    Fältnamn Beskrivning

    Destinations-URL

    Det här är den URL som tar emot data/belastning för spårningshändelser.

    • Kunden ska tillhandahålla en fungerande och giltig destinations-URL.
    • Den angivna destinations-URL:en måste vara i standardiserat syntaktiskt format (säker https-URL).

    Säkerhetstoken

    Använd som delad hemlig nyckel för att autentisera och validera svar från Advanced Integrated Visibility-webhook.

    • Tokenvärdet måste innehålla mellan 26 och 100 tecken.
    • Minst en stor bokstav, en liten bokstav och ett numeriskt tecken krävs.
    • Säkerhetstoken kommer att användas för att skapa en HMAC-signatur för svarsvalidering.

    Språk för data

    Välj önskat språk för översättning av spårningsdata i listrutan. Följande är de sex tillgängliga exempelspråken:

    • Engelska (USA) (standard)

    Spårningstyp

    Välj vilken svarstyp som spårningsdata ska mottas i.

    • Detaljerat spårningssvar (svarstypen består av säkra spårningsdata med den fullständiga händelsehistoriken).(Standard)
    • Händelsespecifikt spårningssvar (svarstypen består av säkra spårningsdata med endast den senaste händelsehistoriken).(Kommer snart)

    Spårningshändelser

    Välj en kategori på högre nivå för att ta emot e-postmeddelanden relaterade till försändelsehändelser i paketets livscykel. Följande är kategorierna på högre nivå:

    • Skicka
    • Under transport
    • Leverans
    • Undantag
    • Beräknad leverans

    Statushändelse

    En spårningshändelse i paketets livscykel. Välj en av följande spårningshändelser som ska tas emot. Här följer de 10 tillgängliga statushändelserna:

    1. Upphämtad
    2. Under transport
    3. Levererad
    4. Leveransundantag

     

    Obs! Fältvärdena för Statushändelser kommer att fyllas i baserat på vald spårningshändelsekategori. Se följande tabell för att lära dig mer om spårningshändelsekategorierna och deras respektive statushändelser.

     

    Statuskategori för händelse Statushändelse

    Skicka
    • Upphämtad

    Under transport
    • Under transport

    Leverans
    • Levererad

    Undantag
    • Leveransundantag

    Beräknad leverans(Kommer snart)
    • Beräknat leveransdatum (EDD)
    • Tidsfönster för beräknad leverans (EDTW)

     

  3. Markera rutan Licensavtal för FedEx Developer Portal (FDPLA) för att signera/godkänna licensavtalet.
  4. Klicka på knappen SKICKA för att visa testresultaten.


Svar:

Följande är svarsparametrarna i sandlådan:

  • Huvuddel – Huvuddelen innehåller svarsparametrarna på fliken Testa webhook-URL i sandlådekonsolen.
  • Status – Det här avsnittet på fliken Testresultat visar statusen för begäran som behandlas.

    • Exempel på meddelande om framgång:
    Levererat
    Händelseuppgifter för test av Advanced Integrated Visibility-spårning har levererats.

 

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

Exempel på framgångsrikt meddelande

Om leveransen av en testhändelse misslyckas kommer STATUS att visas som Fel i fliken Testresultat med respektive felkod och felmeddelande.

Exempel på felmeddelande:
Felkod: <<felkod>>
Leverans av information om testhändelse för Advanced Integrated Visibility-spårning misslyckades.

Exempel på felmeddelande

Valideringsregler:

  • Advanced Integrated Visibility-URL:en måste vara i standardiserat syntaktiskt format.
  • Alla fält som krävs för att testa en Advanced Integrated Visibility-URL måste vara ifyllda.
  • För en lyckad validering:
    • FedEx kommer att skicka en begäran med en exempelhändelse i JSON-format.
      • Obs! Advanced Integrated Visibility-projektets destinations-URL måste svara med HTTP-statuskoden 200 (OK) till FedEx.
  • För misslyckad validering:
    • Om FedEx tar emot något annat svar än 200 (OK) kommer valideringen av Advanced Integrated Visibility-projektets destinations-URL att betraktas som misslyckad.
    • FedEx kommer att visa felkoden och felmeddelandet under fliken Testresultat.

Kalkylator för nyttolastdata

Kalkylatorn för nyttolastdata är utformad för att hjälpa prenumeranter att uppskatta den datamängd som genereras genom webhook-aktivitet. Den ger en översikt över daglig nyttolaststorlek, antal försändelser och spårningshändelser, vilket hjälper användare att fatta välgrundade beslut om dataanvändning och integrationsplanering.

Att använda kalkylatorn

Användare kan ange följande parametrar:

  • Antal försändelser
  • Händelser per försändelse (standard: 5)
  • Daglig nyttolastvolym (beräknas automatiskt)

Baserat på angivna uppgifter, visar kalkylatorn dynamiskt:

  •  Totalt antal spårningshändelser
  •  Daglig nyttolast
  •  Uppskattad total datamängd

Informativa anteckningar:

  •  Antal händelser per försändelse är som standard inställt på to 5. Det här baseras på ett genomsnitt på 17–18 händelser per försändelse och normala leveranstider på 1–7 dagar, beroende på typ av tjänst, transportföretag och destination. Man utgår från en genomsnittlig leveranstid på 3 dagar. Obs! Användaren kan redigera det här värdet.
  •  Daglig nyttolastvolym beräknas som: Antal försändelser × Händelser per försändelse (standard: 5)
  •  Användare behöver bara ange Antal försändelser och klicka “BERÄKNA” för att få fram resultat. Andra värden är antingen standardiserade eller automatiskt beräknade.

Ansvarsfriskrivning: Alla värden som kalkylatorn anger är ungefärliga och de är endast avsedda för planeringsändamål.

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