Fedex Logo

CREA UN
WEBHOOK GESTISCI WEBHOOK

Testare il webhook


Potete utilizzare la funzionalità Testa l'URL del webhook per testare il tipo di dati di monitoraggio restituiti all'URL di destinazione (server destinatario/listener). Ciò aiuta a convalidare l'URL e i dati restituiti prima di creare un webhook di Visibilità integrata avanzata.

Navigazione:

Di seguito sono riportate le modalità per accedere alla console Sandbox Testa l'URL del webhook

  • I miei progetti (nel pannello di navigazione a sinistra) -> scheda Visibilità integrata avanzata -> pulsante Testa l'URL del webhook -> nella console Sandbox, cliccate su Prova questa Visibilità integrata avanzata
  • Catalogo API (nel pannello di navigazione a sinistra) -> cercate Visibilità integrata avanzata/cliccate su Visibilità integrata avanzata in FILTRI -> scheda Visibilità integrata avanzata:
    1. -> Panoramica -> pulsante Documentazione -> nella console sandbox, cliccate su Prova questa Visibilità integrata avanzata.
    2. -> Documenti -> nella console sandbox, fate clic su Prova questa Visibilità integrata avanzata.

Fasi:

Di seguito sono riportati i passaggi per utilizzare la funzionalità Testa l'URL del webhook:

  1. Cliccate sul pulsante Testa l'URL del webhook.
  2. Inserite i parametri di test seguenti:
    Nome del campo Descrizione

    URL di destinazione

    Questo è l'URL per ricevere i dati/il carico utile dell'evento di monitoraggio.

    • Il cliente deve fornire un URL di destinazione funzionante e valido.
    • L'URL di destinazione fornito deve essere in formato sintattico standardizzato (URL https sicuro).

    Token di sicurezza

    Utilizzato come segreto condiviso per autenticare e convalidare la risposta del webhook di Visibilità integrata avanzata.

    • Il valore del token deve avere una lunghezza di minimo 26 caratteri e massimo 100.
    • Sono richiesti almeno 1 maiuscola, 1 minuscola e 1 carattere numerico.
    • Il token di sicurezza verrà utilizzato per creare una firma di Codice di autenticazione del messaggio basata su hash (HMAC) per la convalida della risposta.

    Lingua del payload

    Selezionate la lingua desiderata per la traduzione dei dati di monitoraggio dall'elenco del menù a tendina. Di seguito sono elencate le 6 lingue di esempio disponibili:

    • Inglese (Stati Uniti)(predefinito)

    Tipo monitoraggio

    Selezionate il tipo di risposta in cui i dati di monitoraggio devono essere ricevuti.

    • Risposta di monitoraggio dettagliata (il tipo di risposta consiste in dati di monitoraggio protetti con l'intera cronologia degli eventi).(Impostazione predefinita)
    • Risposta di monitoraggio specifica dell'evento (il tipo di risposta consiste in dati di monitoraggio protetti contenenti solo le più recenti informazioni sull'evento).(In arrivo a breve)

    Eventi di monitoraggio

    Selezionate una categoria di livello superiore per ricevere notifiche tramite email relative agli eventi di spedizione nel ciclo di vita del collo. Di seguito sono elencate le categorie di livello superiore:

    • Spedire
    • In transito
    • Consegna
    • Eccezioni
    • Consegna stimata

    Evento di status

    Evento di monitoraggio nel ciclo di vita dei colli. Selezionate uno degli eventi di monitoraggio da ricevere. Di seguito sono riportati 10 eventi di stato di esempio disponibili:

    1. Ritirata
    2. In transito
    3. Consegnata
    4. Eccezione di consegna

     

    Nota: i valori del campo "Evento di stato" verranno popolati in base alla "Categoria evento di monitoraggio". Fate riferimento alla tabella seguente per maggiori informazioni sulla "Categoria evento di monitoraggio" e sui rispettivi "Eventi di stato".

     

    Categoria status Evento di status

    Spedire
    • Ritirata

    In transito
    • In transito

    Consegna
    • Consegnata

    Eccezioni
    • Eccezione di consegna

    Consegna stimata(In arrivo a breve)
    • Data di consegna stimata (EDD)
    • Finestra oraria di consegna stimata (EDTW)

     

  3. Selezionate la casella FedEx Developer Portal License Agreement (FDPLA) (Contratto di licenza del FedEx Developer Portal (FDPLA)) per firmare/accettare il contratto di licenza.
  4. Fate clic sul pulsante PUSH (INVIARE) per visualizzare i risultati del test.


Risposta:

Di seguito sono riportati i parametri di risposta nella sandbox:

  • Body – Il corpo contiene i parametri di risposta nella scheda Test Webhook URL (Testare l'URL del webhook) all'interno della console sandbox.
  • Status – Questa sezione nella scheda Test Results (Risultati del test) fornisce lo stato della richiesta elaborata.

    • Esempio di messaggio di operazione riuscita:
    Operazione riuscita
    Dettagli dell'evento di monitoraggio di test della Visibilità integrata avanzata inviati correttamente.

 

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

Esempio di messaggio di operazione riuscita

Se l'invio dell'evento di test non riesce, lo STATUS (STATO) verrà visualizzato come Error (Errore) nella scheda Test Results (Risultati del test) con il rispettivo codice e messaggio di errore.

Esempio di messaggio di errore:
Codice di errore:<<codice errore>>
Invio dei dettagli dell'evento di monitoraggio di test della Visibilità integrata avanzata non riuscito.

Esempio di messaggio di errore

Regole di convalida:

  • L'URL della Visibilità integrata avanzata deve essere in formato sintattico standardizzato.
  • Nessun campo obbligatorio per il test di un URL della Visibilità integrata avanzata deve essere vuoto.
  • Per una convalida riuscita:
    • FedEx invierà una richiesta con l'evento di esempio JSON.
      • Nota: l'URL di destinazione della Visibilità integrata avanzata deve rispondere a FedEx con il codice di stato HTTP 200 (OK).
  • Per una convalida non riuscita:
    • Se FedEx riceve una risposta diversa da 200 (OK), la convalida dell'URL di destinazione della Visibilità integrata avanzata verrà considerata non riuscita.
    • FedEx visualizzerà il codice e il messaggio di errore nella scheda Test Results (Risultati del test).

Calcolatore del payload di dati

Il Calcolatore del payload di dati è progettato per aiutare gli iscritti a stimare il volume di dati generati tramite l'attività webhook. Offre visibilità sulle dimensioni del payload giornaliero, sul numero di spedizioni e sugli eventi di monitoraggio, aiutando gli utenti a prendere decisioni informate sull'utilizzo dei dati e sulla pianificazione dell'integrazione.

Utilizzo del calcolatore

Gli utenti possono inserire i seguenti parametri:

  • Numero di spedizioni
  • Eventi per spedizione (predefinito: 5)
  • Volume del payload giornaliero (calcolato automaticamente)

In base a questi input, il calcolatore mostra in modo dinamico:

  •  Totale eventi di monitoraggio
  •  Payload giornaliero
  •  Dimensione totale stimata dei dati

Note informative:

  •  Il valore predefinito per Eventi per spedizione è 5. Questo dato si basa su una media di 17–18 eventi per spedizione e tempi di consegna tipici di 1–7 giorni, a seconda del tipo di servizio, del vettore e della destinazione. Si prevede un tempo medio di consegna di 3 giorni. Nota: questo valore può essere modificato dall'utente.
  •  Il Volume giornaliero del payload è calcolato come: Numero di spedizioni × Eventi per spedizione (predefinito: 5)
  •  Gli utenti devono semplicemente inserire il numero di spedizioni e cliccare su "CALCOLA" per generare i risultati. Gli altri valori sono predefiniti o calcolati automaticamente.

Dichiarazione di esclusione di responsabilità: tutti i valori forniti dal calcolatore sono approssimativi e hanno solo scopo indicativo.

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