• Samaa lähettäjän asiakasnumeroa ei voi käyttää useissa Laajennettu integroitu näkyvyys -projekteissa.
• Asiakkaan luoman kohde-URL-osoitteen/päätepisteen vaatimukset:
  
  • Täytyy olla HTTPS-isännöity.
    
  • Vastaa POST-pyyntöihin ja jäsentää JSON-hyötykuormia.
  • Enintään 200 merkkiä
  • URL-osoitteesi estetään, jos se sisältää seuraavaa:
    • IP-osoiteavaruus RFC1918
    • verkkotunnus fedex.com ja sen aliverkkotunnukset
    • IP-osoitteet URL-osoitteessa (mukaan lukien localhost, 127.0.0.1).

• Laajennetun integroidun näkyvyyden suojaus: Tuettuja ovat vain HTTPS-yhteydet, joissa käytetään vähintään TLS (SSL) 1.2 -protokollaversioita, jotka on määritetty kelvolliselta sertifiointiauktoriteetilta (CA) saadulla sertifikaatilla. Salli alla olevat IP-osoitteet, jotta päivitykset saadaan FedEx-palvelimista keskeytyksettä:
  

  Tuot.
  Seuraavan voi sallia: “nat.fxconnect.eastus2.heap-prod.fedex.io”
  Luokattomalla reitityksellä "20.65.16.22/31"

• Asiakkaat saattavat saada seurantatapahtuman päivitykset joskus väärässä järjestyksessä, jolloin oikea järjestys selviää katsomalla skannaustapahtuman aikaleimaa.
• Asiakasnumeroiden poistaminen FedEx Developer Portalissa:
  • Käyttäjä/asiakas ei voi poistaa asiakasnumeroita seuraavissa tilanteissa:
    1. Jos se on liitetty vähintään yhteen Laajennettu integroitu näkyvyys -projektiin.
       
    2. Kyseinen asiakasnumero on käytettävissä tai liitetty projektiin.
    3. Jos se on projektin ainoa asiakasnumero / Laajennettu integroitu näkyvyys.
       
       Huomaa: Käyttäjän/asiakkaan on poistettava asiakasnumero ensin projektista / Laajennetusta integroidusta näkyvyydestä ja sitten organisaatiosta.
  • Käyttäjä/asiakas voi poistaa asiakasnumeroita seuraavin edellytyksin:
    1. Asiakasnumeron täytyy kuulua samalle organisaatiolle.
    2. Käyttäjän/asiakkaan on oltava ylläpitäjä voidakseen poistaa asiakasnumeroita organisaatiosta.

Yleiset rajoitukset

• Toiminto kattaa kaikki asiakkaiden lähetykset, joiden FedExin 9-numeroiset asiakasnumerot liittyvät palveluja toimittaviin yrityksiin FedEx Express®, FedEx Ground® ja FedEx Ground® Economy (aiemmin FedEx SmartPost®) määränpäästä tai lähetyspaikasta riippumatta (mm. saapuvat, lähtevät, kansainväliset, kotimaan lähetykset jne.).
• Laajennettu integroitu näkyvyys ‑webhook tukee vain 9-numeroisia yritysten ja pakettien asiakasnumeroita. Yritysten asiakasnumeroilla voidaan luoda lähetyksiä, jotka liittyvät kaikkiin FedEx-yhtiöön kuuluviin yrityksiin, mukaan lukien FedEx Express ja FedEx Ground.


Huomaa: 9-numeroisia vain LTL-rahtiin käytettäviä asiakasnumeroita ei tueta. Jos haluat lisätä LTL-rahtiasiakasnumeron, ota yhteyttä asiakaspalveluun yhtiön LTL-asiakasnumeron käyttöä varten.
• Asiakkaiden on hallittava lähetysten vastaanotettujen seurantatapahtumien järjestystä omassa päässään.
• Sähköposti-ilmoitukset lähetetään automaattisesti, jos tilatulla Laajennettu integroitu näkyvyys ‑webhookilla on toimintaa (tallennettu/epäonnistui/luonti/päivitys/peruutus/poisto).
• Käännökset:
  • Seurannan hyötykuormien käännökset ovat saatavilla 41 kielellä (maakohtaisesti).(tulossa pian)
    Katso tuetut kielet napsauttamalla tätä.
  • Seurannan hyötykuormien käännöksiä tuetaan tällä hetkellä englanniksi (Yhdysvallat).
  • Sähköposti-ilmoitusten käännökset ovat saatavilla vain kielillä, joita tuetaan Yhdysvaltojen alueilla. (Kielet: en-US, es-US)

FedEx Developer Portalin käyttäjäroolit:

Käyttäjä voi suorittaa FedEx Developer Portalissa tiettyjä toimintoja määritetyn roolinsa mukaisesti.
Lisätietoja FedEx Developer Portalista on Organisaation hallintaoppaassa.

Mikä on MAC/HMAC, ja miten sitä käytetään vahvistusprosessissa?

Viestin todennuskoodi (MAC) on salaiseen avaimeen perustuva menetelmä, jolla tarkistetaan lähetettävien tietojen tai epäluotettavan tallennusvälineen tietojen eheys. MAC-koodeja käytetään tyypillisesti salaisen avaimen jakamiseen kahdelle osapuolelle, jotta osapuolten välillä lähetetyt tiedot voidaan vahvistaa.

Kryptografisiin hajautustoimintoihin perustuva MAC-mekanismi on nimeltään HMAC. HMAC:n kanssa voidaan käyttää mitä tahansa kryptografista hajautustoimintoa, kuten SHA256:ta, ja jaettua salaista avainta. HMAC määritetään RFC 2104:ssä. FedExin Laajennettu integroitu näkyvyys ‑webhook käyttää HMAC SHA256:ta.

SHA256 (suojaustunniste + hyötykuorma) =  Base 64 -koodattu fdx-allekirjoitus osana hyötykuorman otsikkoa

Viiveen laskenta

Tapahtuman luontiaika kuvaa sitä, milloin tapahtuma todellisuudessa tapahtui verkossa.
Ennen kuin tapahtuma on kirjattu sisään järjestelmään (mistä on merkkinä viestin luontiaikaleima), webhookit tai muut järjestelmät eivät voi käsitellä tai toimittaa sitä.

Suositus

Asiakkaiden tulisi käyttää viestin luontiaikaleimaa viiveen mittaamiseen, sillä se kuvaa parhaiten sitä, milloin tapahtuma tuli digitaalisten järjestelmien saataville. Tämä aikaleima on lähimpänä FedExin digitaalisten päivitysten ajoitusta ja tyypillisesti nopeampi – tai lähes sama kuin – fedex.com-sivustolla näkyvät päivitykset.

Vahvistussäännöt: 

• Laajennettu integroitu näkyvyys ‑webhookin nimen on oltava ainutkertainen.
• Laajennettu integroitu näkyvyys ‑webhookin määränpään URL-osoitteen on oltava standardin mukaisessa syntaktisessa muodossa.
• Laajennettu integroitu näkyvyys ‑webhookin  luomisen yhteydessä pakolliset kentät eivät saa olla tyhjiä.
• Vähintään yksi käytettävissä oleva FedExin lähettäjän asiakasnumero on liitettävä, kun Laajennettu integroitu näkyvyys ‑webhook  luodaan.
• Onnistunut vahvistus:
  • Kun Laajennettu integroitu näkyvyys  ‑webhookin  luominen on onnistunut, asiakkaalle lähetetään vahvistusviesti.

    Vahvistusviestin esimerkki: <<Laajennettu integroitu näkyvyys ‑webhookin nimi>> on luotu. Muutosten päivittyminen voi kestää 10 minuuttia.

• Epäonnistunut vahvistus:
  • Jos FedEx vastaanottaa minkä tahansa muun vastauksen kuin 200 (OK) tai 202 (Hyväksytty), Laajennettu integroitu näkyvyys ‑webhookin  määränpään URL-osoitteen vahvistus katsotaan epäonnistuneeksi.