Sandbox Console
Webhook testen
U kunt de functie Webhook-URL testen gebruiken om het type trackinggegevens te testen dat wordt geretourneerd naar de bestemmings-URL (ontvanger/ontvangende server). Hiermee kunt u de URL en de geretourneerde gegevens valideren voordat u een Advanced Integrated Visibility-webhook aanmaakt.
Navigatie:
Hieronder vindt u de manieren om naar de Sandbox-console voor Webhook-URL testen te gaan:
- Mijn projecten (aan de linkerkant van het navigatiescherm) -> tabblad Advanced Integrated Visibility -> knop webhook-URL testen ->in de Sandbox-console, klik op Probeer deze Advanced Integrated Visibility
- API-catalogus (aan de linkerkant van het navigatiescherm) -> zoek naar Geavanceerde geïntegreerde zichtbaarheid/klik op Geavanceerde geïntegreerde zichtbaarheid in FILTERS -> de kaart Geavanceerde geïntegreerde zichtbaarheid:
- -> Overzicht -> knop Documentatie -> klik in de Sandbox-console op Deze Geavanceerde geïntegreerde zichtbaarheid proberen.
- -> Documenten -> klik in de Sandbox-console op Deze Geavanceerde geïntegreerde zichtbaarheid proberen.
Stappen:
Hieronder staan de stappen om de functie Webhook-URL testen te gebruiken:
- Klik op de knop Webhook-URL testen.
- Vul de volgende testparameters in:
Veldnaam Omschrijving Bestemmings-URL
Dit is de URL om trackinggebeurtenisgegevens/laadvermogens te ontvangen.
- De klant moet een werkende en geldige bestemmings-URL opgeven.
- De opgegeven bestemmings-URL moet de gestandaardiseerde syntactische indeling hebben (beveiligde HTTPS-URL).
Beveiligingstoken
Dit wordt gebruikt als gedeeld geheim om de respons van de Advanced Integrated Visibility-webhook te verifiëren en te valideren.
- De tokenwaarde moet minimaal 26 tekens en maximaal 100 tekens lang zijn.
- Ten minste 1 hoofdletter, 1 kleine letter en 1 cijfer zijn vereist.
- Het beveiligingstoken wordt gebruikt om een hash-gebaseerde berichtauthenticatiecode-handtekening (HMAC) te maken voor reactievalidatie.
Taal van nettolading
Selecteer de voorkeurstaal voor de vertaling van de trackinggegevens in de keuzelijst. Dit zijn de zes beschikbare voorbeeldtalen:
- Engels (Verenigde Staten)(Standaard)
Trackingtype
Selecteer het reactietype waarin de trackinggegevens moeten worden ontvangen.
- Gedetailleerde trackingreactie (reactietype bestaat uit beveiligde trackinggegevens met een volledige gebeurtenisgeschiedenis).(Standaard)
- Gebeurtenisspecifieke trackingreactie (reactietype bestaat uit beveiligde trackinggegevens met alleen de recentste gebeurtenisgegevens).(Binnenkort beschikbaar)
Trackinggebeurtenissen
Selecteer een van de bovenliggende categorieën om e-mailmeldingen te ontvangen over gebeurtenissen tijdens de verzending van het pakket. Dit zijn de bovenliggende categorieën:
- Verzenden
- In transit
- Aflevering
- Uitzonderingen
- Verwachte levering
Statusgebeurtenis
Een trackinggebeurtenis tijdens de verzending van het pakket. Selecteer een van de trackinggebeurtenissen die u wilt ontvangen. Dit zijn voorbeelden van de 10 beschikbare statusgebeurtenissen:
- Opgehaald
- Onderweg
- Afgeleverd
- Afleveringsuitzondering
Opmerking: 'Statusgebeurtenis' -veldwaarden worden ingevuld op basis van de geselecteerde 'Categorie trackinggebeurtenis'. Raadpleeg de volgende tabel voor meer informatie over de 'Categorie trackinggebeurtenis' en de bijbehorende 'Statusgebeurtenissen'.
Status gebeurteniscategorie Statusgebeurtenis Verzenden
- Opgehaald
Onderweg
- Onderweg
Aflevering
- Afgeleverd
Uitzonderingen
- Afleveringsuitzondering
Verwachte levering(Binnenkort beschikbaar)
- Verwachte leverdatum (EDD)
- Verwachte leverperiode (EDTW)
- Vink het selectievakje voor de Licentieovereenkomst voor FedEx Developer Portal aan om de licentieovereenkomst te ondertekenen/accepteren.
- Klik op de knop PUSH om de testresultaten te bekijken.
Antwoord:
Dit zijn de reactieparameters in de Sandbox:
- Tekst – De tekst bevat de reactieparameters in het tabblad Webhook-URL testen binnen de Sandbox-console.
- Status – Dit gedeelte op het tabblad Testresultaten geeft de status van het verzoek weer dat wordt verwerkt.
Voorbeeld succesbericht:
Geslaagd
Testgegevens van Geavanceerde geïntegreerde zichtbaarheid-trackinggebeurtenis zijn afgeleverd.
Status
Success
Test webhook tracking event details delivered successfully
Error
Test webhook tracking event details delivery failed
Als de testgebeurtenis niet wordt afgeleverd, wordt de STATUS weergegeven als Fout op het tabblad Testresultaten, samen met de bijbehorende foutcode en foutmelding.
Voorbeeld foutmelding:
Foutcode:<<foutcode>>
Testgegevens van Geavanceerde geïntegreerde zichtbaarheid-trackinggebeurtenis zijn niet afgeleverd.
Validatieregels:
- De URL voor Geavanceerde geïntegreerde zichtbaarheid moet de gestandaardiseerde syntactische indeling hebben.
- Alle vereiste velden voor het testen van een Geavanceerde geïntegreerde zichtbaarheid-URL moeten ingevuld zijn.
- Voor geslaagde validatie:
- FedEx stuurt een verzoek met een voorbeeld van een JSON-gebeurtenis. Let op: de bestemmings-URL van de Geavanceerde geïntegreerde zichtbaarheid moet reageren met een HTTP-statuscode 200 (OK) naar FedEx.
- Voor niet-geslaagde/mislukte validatie:
- Als FedEx een andere reactie ontvangt dan 200 (OK), wordt de validatie van de bestemmings-URL van de Geavanceerde geïntegreerde zichtbaarheid beschouwd als mislukt.
- FedEx zal de foutcode en foutmelding weergeven op het tabblad Testresultaten
Rekenmachine voor gegevenslaadvermogen
De Rekenmachine voor gegevenslaadvermogen is ontworpen om abonnees te helpen de hoeveelheid data te schatten die wordt gegenereerd door webhook-activiteit. Het biedt inzicht in de dagelijkse grootte van het laadvermogen, het aantal zendingen en trackinggebeurtenissen, zodat gebruikers weloverwogen beslissingen kunnen nemen over gegevensgebruik en integratieplanning.
De rekenmachine gebruiken
Gebruikers kunnen de volgende parameters invoeren:
- Aantal zendingen
- Gebeurtenissen per zending (standaard: 5)
- Dagelijks laadvermogen (automatisch berekend)
Op basis van deze invoer toont de rekenmachine dynamisch:
- Totaal aantal trackinggebeurtenissen
- Dagelijkse laadvermogen
- Geschatte totale gegevensgrootte
Informatieve opmerkingen:
- Gebeurtenissen per zending is standaard ingesteld op 5. Dit is gebaseerd op een gemiddelde van 17-18 gebeurtenissen per zending en typische levertijden van 1-7 dagen, afhankelijk van het servicetype, de vervoerder en de bestemming. Er wordt uitgegaan van een gemiddelde levertijd van 3 dagen. Let op: deze waarde kan door de gebruiker worden bewerkt.
- Dagelijks laadvermogen wordt berekend als: aantal zendingen × gebeurtenissen per zending (standaard: 5)
- Gebruikers hoeven alleen het aantal zendingen in te voeren en op 'BEREKENEN' te klikken om resultaten te genereren. Andere waarden worden standaard ingesteld of automatisch berekend.
Disclaimer: alle waarden die door de rekenmachine worden verstrekt, zijn schattingen en alleen bedoeld voor planningsdoeleinden.
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.
