Per aggiungere un numero di monitoraggio alla vostra sottoscrizione al webhook usando l'API di Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata, attenetevi ai passaggi seguenti:

1. Create un progetto Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata usando le fasi riportate nella sezione precedente o le fasi indicate nella Guida introduttiva.
2. Per avviare le chiamate all'API Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata è necessario un token OAuth. Per generare un token OAUTH, utilizzate l'API Autorizzazione. Per conoscere le fasi dettagliate per generare un token OAUTH, fate riferimento alla documentazione dell'API Autorizzazione nel catalogo API.
3. Cliccate sull'opzione Dettagli del progetto nel menu di navigazione a sinistra. Nella scheda Chiavi di produzione, scorrete verso il basso fino a trovare la documentazione dell'API Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata.

Nella documentazione dell' API Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata troverete tre endpoint:

Endpoint di associazione del numero di monitoraggio

• Utilizzate questo endpoint per aggiungere o rimuovere i numeri di monitoraggio a una determinata iscrizione al Webhook. Maggiori dettagli sono disponibili nella documentazione dell'API Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata.
• Qualsiasi aggiunta o rimozione di numeri di monitoraggio è un lavoro asincrono. Un ID lavoro è stato inviato come risposta per aggiungere o rimuovere la chiamata API di associazione del numero di monitoraggio.

Endpoint sui dettagli del lavoro per numero di monitoraggio

Questo endpoint offre dettagli su un ID lavoro specifico, ad esempio, su tutti i numeri di monitoraggio inviati, quanti sono stati aggiunti correttamente a una determinata iscrizione al webhook o quanti sono ancora in fase di elaborazione.

Endpoint suo stato del lavoro per numero di monitoraggio

Questo endpoint vi consentirà di ottenere un riepilogo attuale di tutti i lavori in fase di elaborazione.

1. Utilizzate il token AUTH generato nella Fase 2 con l'endpoint di associazione del numero di monitoraggio per aggiungere numeri di monitoraggio all'iscrizione al webhook.

Regole di convalida:

• Il nome del webhook deve essere univoco.
• L'URL di destinazione del webhook deve essere in formato sintattico standardizzato.
• Nessun campo obbligatorio per la creazione di un webhook deve essere vuoto.
• Per creare un webhook è necessario associare almeno un Codice Cliente di spedizione FedEx disponibile.
• Per una convalida riuscita:
  • Quando un webhook viene creato correttamente, il cliente riceverà un messaggio di conferma.

    Esempio di messaggio di conferma: <<Webhook name>> successfully created. Changes may take up to 10 minutes to go into effect. L'applicazione delle modifiche può richiedere fino a 10 minuti.

• Per una convalida non riuscita:
  • Se FedEx riceve una risposta diversa da 200 (OK) o 202 (accepted, accettato), la convalida dell'URL di destinazione del webhook verrà considerata non riuscita.