Sandbox Console
Webhookin testaus
Webhookin URL-osoitteen testausominaisuudella voi testata määränpään URL-osoitteeseen (vastaanottaja-/kuuntelupalvelimeen) saapuvien seurantatietojen tyyppiä. Tämä auttaa vahvistamaan URL-osoitteen ja palautetut tiedot ennen Laajennettu integroitu näkyvyys ‑webhookin luomista.
Siirtyminen:
Voit siirtyä testiympäristön konsolissa kohtaan Testaa webhookin URL-osoite seuraavilla tavoilla:
- Omat projektit (vasemmassa siirtymispalkissa) -> Laajennettu integroitu näkyvyys -välilehti -> Testaa webhookin URL-osoite -painike -> testiympäristön konsolissa, napsauta Kokeile tätä Laajennettu integroitu näkyvyys
- API-luettelo (vasemmassa siirtymispaneelissa) -> hae Laajennettua integroitua näkyvyyttä / napsauta Laajennettu integroitu näkyvyys SUODATTIMET -> Laajennettu integroitu näkyvyys -kortti:
- -> Yhteenveto -> Dokumentaatio-painike -> napsauta testiympäristön konsolissa kohtaa Kokeile tätä Laajennettu integroitu näkyvyys.
- -> Dokumentit -> napsauta testiympäristön konsolissa kohtaa Kokeile tätä Laajennettu integroitu näkyvyys.
Vaiheet:
Toimintoa Testaa webhookin URL-osoite käytetään seuraavasti:
- Napsauta Testaa webhookin URL-osoite ‑painiketta.
- Lisää seuraavat testiparametrit:
Kentän nimi Kuvaus Kohde-URL
Seurantatapahtuman tiedot/hyötykuorma lähetetään tähän URL-osoitteeseen.
- Asiakkaan on annettava toimiva ja kelvollinen kohde-URL-osoite.
- Annetun kohde-URL-osoitteen on oltava standardin mukaisessa synktaktisessa muodossa (suojattu https-URL-osoite).
Suojaustunniste
Käytetään jaettuna salaisuutena Laajennettu integroitu näkyvyys ‑webhookin vastauksen todentamiseen ja vahvistamiseen.
- Tunnisteen arvon pituuden on oltava vähintään 26 merkkiä ja enintään 100 merkkiä.
- Vähintään yksi iso kirjain, yksi pieni kirjain ja yksi numero vaaditaan.
- Suojaustunnisteella luodaan hajautuspohjaisen viestin todennuskoodin (HMAC) allekirjoitus vastauksen vahvistukselle.
Hyötykuorman kieli
Valitse avattavasta valikosta seurantatietojen käännöksen ensisijainen kieli. Tiedot ovat saatavilla tällä hetkellä kuudella kielellä:
- Englanti (Yhdysvallat)(oletus)
Seurantatapa
Valitse vastaustyyppi seurantatietojen vastaanottamista varten.
- Yksityiskohtainen seurantavastaus (Vastaustyyppi kattaa koko tapahtumahistorian suojatut seurantatiedot.)(Oletus)
- Tapahtumakohtainen seurantavastaus (Vastaustyyppi kattaa vain viimeisimmän tapahtuman suojatut seurantatiedot.)(Tulossa pian)
Seurantatapahtumat
Valitse yksi ylätason luokka paketin elinkaaren lähetystapahtumiin liittyvien sähköposti-ilmoitusten vastaanottamista varten. Ylätason luokat ovat seuraavat:
- Lähetä
- Matkalla
- Toimitus
- Poikkeukset
- Arvioitu toimitus
Tilan tapahtuma
Pakettien elinkaaren seurantapahtuma. Valitse yksi vastaanotettava seurantatapahtuma. Seuraavat 10 näytetilatapahtumaa ovat saatavilla tällä hetkellä:
- Noudettu
- Kuljetettavana
- Toimitettu
- Toimituspoikkeama
Huomaa: Tilan tapahtuma ‑kentän arvot täytetään Seurantatapahtuman luokka ‑valinnan mukaan. Katso lisätietoja seuraavan taulukon kohdista Seurantatapahtuman luokka ja Tilan tapahtuma.
Tapahtuma Tilan tapahtuma Lähetä
- Noudettu
Matkalla
- Kuljetettavana
Toimitus
- Toimitettu
Poikkeukset
- Toimituspoikkeama
Arvioitu toimitus(Tulossa pian)
- Arvioitu toimituspäivä (EDD)
- Arvioitu toimitusaikaväli (EDTW)
- Allekirjoita/hyväksy käyttöoikeussopimus valitsemalla FedEx Developer Portalin käyttöoikeussopimus (FDPLA) ‑valintaruutu.
- Katso testitulokset napsauttamalla PUSH-painiketta.
Vastaus:
Testiympäristön vastausparametrit ovat seuraavat:
- Tekstiosa – Tekstiosa sisältää vastausparametrit testiympäristön konsolin välilehdellä Testaa webhookin URL-osoite.
- Tila – Käsiteltävän pyynnön tila esitetään tässä Testitulokset-välilehden kohdassa.
Onnistumissanoman esimerkki:
Onnistui
Testaa Laajennetun integroidun näkyvyyden seurantatapahtuman toimitus onnistui.
Status
Success
Test webhook tracking event details delivered successfully
Error
Test webhook tracking event details delivery failed
Jos testitapahtuman toimitus epäonnistuu, Testitulokset-välilehden TILA-kohdassa näkyy Virhe sekä vastaava virhekoodi ja ‑ilmoitus.
Virheilmoituksen esimerkki:
Virhekoodi:<<virhekoodi>>
Laajennetun integroidun näkyvyyden seurantatapahtuman testitietojen toimitus epäonnistui.
Vahvistussäännöt:
- Laajennetun integroidun näkyvyyden URL-osoitteen on oltava standardin mukaisessa syntaktisessa muodossa.
- Laajennetun integroidun näkyvyyden URL-osoitteen testauksen pakolliset kentät eivät saa olla tyhjiä.
- Onnistunut vahvistus:
- FedEx lähettää pyynnön mallitapahtumalla JSON. Huomaa: Laajennetun integroidun näkyvyyden määränpään URL-osoitteen on vastattava FedExille HTTP-tilakoodilla 200 (OK).
- Epäonnistunut vahvistus:
- Jos FedEx vastaanottaa minkä tahansa muun vastauksen kuin 200 (OK), Laajennetun integroidun näkyvyyden määränpään URL-osoitteen vahvistus katsotaan epäonnistuneeksi.
- FedExin virhekoodi ja ‑ilmoitus näytetään Testitulokset-välilehdellä.
Tietojen hyötykuorman laskuri
Tietojen hyötykuorman laskuri on suunniteltu auttamaan tilaajia arvioimaan webhook-toiminnan tuottaman datan määrää. Se tarjoaa näkyvyyden päivittäisten hyötykuormien kokoihin, lähetysten lukumääriin ja seurantatapahtumiin, mikä auttaa käyttäjiä tekemään tietoon perustuvia päätöksiä tietojen käytöstä ja integroinnin suunnittelusta.
Laskimen käyttö
Käyttäjät voivat syöttää seuraavat parametrit:
- lähetysten lukumäärä
- tapahtumat lähetystä kohden (oletus: 5)
- päivittäinen hyötykuorman määrä (lasketaan automaattisesti).
Näiden syötteiden perusteella laskuri näyttää dynaamisesti seuraavat:
- seurantatapahtumien kokonaismäärä
- päivittäinen hyötykuorma
- tietojen arvioitu kokonaiskoko.
Tiedotusluonteiset huomautukset:
- Tapahtumia lähetystä kohden on oletusarvoisesti viisi. Tämä perustuu keskimäärin 17–18 tapahtumaan lähetystä kohden ja tyypillisiin 1–7 päivän toimitusaikoihin palvelutyypistä, kuljetusliikkeestä ja määränpäästä riippuen. Keskimääräisen toimitusajan oletetaan olevan kolme päivää. Huomautus: käyttäjä voi muokata tätä arvoa.
- Päivittäinen hyötykuorman määrä lasketaan seuraavasti: lähetysten määrä × tapahtumat lähetystä kohden (oletus: 5)
- Käyttäjien tarvitsee vain syöttää lähetysten määrä ja napsauttaa LASKE tulosten luomiseksi. Muut arvot ovat oletusarvoja, tai ne lasketaan automaattisesti.
Vastuuvapauslauseke: kaikki laskurin antamat arvot ovat arvioita ja tarkoitettu vain suunnittelutarkoituksiin.
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.
