Om een tracking-nummer aan uw webhookabonnement toe te voegen met behulp van de API voor het abonnement op basis van tracking-nummer voor Advanced Integrated Visibility, volgt u de volgende stappen:

1. Maak een project voor het op trackingnummer gebaseerde abonnement voor Geavanceerde geïntegreerde zichtbaarheid door de stappen te volgen die u in het vorige gedeelte hebt gekregen, of gebruik de stappen in de Gids om aan de slag te gaan.
2. U hebt een OAuth-token nodig om API-oproepen voor op trackingnummer gebaseerde abonnementen voor Geavanceerde geïntegreerde zichtbaarheid te starten. Gebruik de autorisatie-API om een OAuth-token te genereren. Ga naar de documentatie over de autorisatie-API in de API-catalogus voor de uitgebreide stappen om een OAuth-token te genereren.
3. Klik op de optie Projectgegevens aan de linkerkant van het navigatiescherm. Scrol op het tabblad Productiesleutels naar beneden om de documentatie over de API voor op trackingnummer gebaseerde abonnementen voor Geavanceerde geïntegreerde zichtbaarheid te vinden.

Zodra u naar de documentatie over de API voor op trackingnummer gebaseerde abonnementen voor Geavanceerde geïntegreerde zichtbaarheid gaat, ziet u drie eindpunten:

Eindpunt gekoppeld aan trackingnummer

• Gebruik dit eindpunt om trackingnummers aan een bepaald webhookabonnement toe te voegen of daaruit te verwijderen. Ga voor meer informatie naar de documentatie over de API voor op trackingnummer gebaseerde abonnementen voor Geavanceerde geïntegreerde zichtbaarheid.
• Elke toevoeging of verwijdering van trackingnummers is een asynchrone taak. Een taak-ID wordt verstuurd als respons om de koppeling van een API-oproep aan trackingnummer toe te voegen of te verwijderen.

Taakinformatie eindpunt voor trackingnummer

Dit eindpunt biedt informatie over een bepaalde taak-ID, zoals hoeveel van de ingediende trackingnummers er zijn toegevoegd aan het bepaalde webhookabonnement of hoeveel er nog steeds worden verwerkt.

Taakstatus eindpunt voor trackingnummer

Dit eindpunt stelt u in staat om een actueel overzicht te krijgen van alle taken die worden verwerkt.

1. Gebruik de gegenereerde AUTH-token in Stap 2 met het eindpunt gekoppeld aan het trackingnummer om trackingnummers toe te voegen aan uw webhookabonnement.

Validatieregels:

• De webhooknaam moet uniek zijn.
• De bestemmings-URL van de webhook moet de gestandaardiseerde syntactische indeling hebben.
• Alle vereiste velden voor het aanmaken van een webhook moeten ingevuld zijn.
• Er moet ten minste één beschikbaar FedEx-verzendaccountnummer worden gekoppeld om een webhook aan te maken.
• Voor geslaagde validatie:
  • De klant ontvangt een bericht ter bevestiging als een webhook is aangemaakt.

    Voorbeeld bevestigingsbericht: <<Webhooknaam>> is aangemaakt. 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 (Accepted), wordt de validatie van de bestemmings-URL van de webhook beschouwd als mislukt.