Aby dodać numer przesyłki do subskrypcji elementu webhook za pomocą interfejsu API subskrypcji Advanced Integrated Visibility opartej na numerze przesyłki, wykonaj następujące czynności:

1. Utwórz projekt subskrypcji Advanced Integrated Visibility opartej na numerze monitorowania, wykonując kroki podane w poprzedniej sekcji lub w Przewodniku po pierwszych krokach.
2. Do zainicjowania wywołań interfejsu API dla subskrypcji Advanced Integrated Visibility opartej na numerze monitorowania potrzebny jest token OAuth. Do wygenerowania tokenu OAUTH użyj interfejsu API autoryzacji. Szczegółowe informacje na temat generowania tokenu OAUTH znajdują się w katalogu API w dokumentacji interfejsu API autoryzacji.
3. Kliknij opcję Szczegóły projektu w lewym panelu nawigacyjnym. Na karcie Klucze produkcyjne przewiń w dół i znajdź dokumentację interfejsu API subskrypcji Advanced Integrated Visibility opartej na numerze monitorowania.

Dokumentacja interfejsu API subskrypcji Advanced Integrated Visibility opartej na numerze monitorowania zawiera trzy punkty końcowe:

Punkt końcowy powiązania numeru monitorowania przesyłki

• Ten punkt końcowy służy do dodawania numerów monitorowania do danej subskrypcji elementu webhook lub ich usuwania. Więcej szczegółów znajduje się w dokumentacji interfejsu API subskrypcji Advanced Integrated Visibility opartej na numerze monitorowania.
• Każde dodanie lub usunięcie numerów monitorowania jest zadaniem asynchronicznym. Identyfikator zadania zostaje wysłany jako odpowiedź w celu dodania lub usunięcia wywołania interfejsu API powiązania numeru monitorowania przesyłki.

Punkt końcowy szczegółów zadania numeru monitorowania przesyłki

Ten punkt końcowy zawiera szczegóły danego identyfikatora zadania, np. ile ze wszystkich przesłanych numerów monitorowania przesyłki zostało dodanych do subskrypcji elementu webhook lub ile nadal jest przetwarzanych.

Punkt końcowy statusu zadania numeru monitorowania przesyłki

Ten punkt końcowy pozwoli Ci pobrać bieżące podsumowanie wszystkich przetwarzanych zadań.

1. Użyj wygenerowanego tokenu AUTH z kroku 2 z punktem końcowym Powiązania numeru monitorowania przesyłki, aby dodać numery monitorowania do subskrypcji elementu webhook.

Zasady weryfikacji:

• Nazwa elementu webhook powinna być unikatowa.
• Adresy URL miejsca przeznaczenia elementów webhook muszą mieć standardowy format pod względem składni.
• Konieczne jest wypełnienie wszystkich wymaganych pól związanych z tworzeniem elementu webhook.
• Utworzenie elementu webhook wymaga powiązania przynajmniej jednego z dostępnych numerów konta wysyłkowego FedEx.
• W przypadku weryfikacji pomyślnej:
  • Po pomyślnym utworzeniu elementu webhook klient otrzyma wiadomość z potwierdzeniem.

    Przykładowa wiadomość z potwierdzeniem: Pomyślnie utworzono element webhook <<Webhook name>>. Wprowadzenie zmian może potrwać do 10 minut.

• W przypadku nieudanej weryfikacji/błędu weryfikacji:
  • Jeżeli FedEx otrzyma odpowiedź ze statusem kodu innym niż 200 (OK) lub 202 (zaakceptowany), weryfikacja adresu URL miejsca przeznaczenia elementu webhook zostanie uznana za nieudaną.