Kundeoplæring i API'en Sandbox Virtualization
Hvad er Sandbox Virtualization?
Sandbox Virtualization API'en er en service, der stimulerer forløbet for et live sandbox-svar. Vores virtualiserede service giver en konsistent oplevelse, hvor svaret, du modtager, er foruddefineret og ikke altid varierer baseret på de specifikke inputværdier, du angiver.
Her er et eksempel: Lad os sige, du foretager flere opkald med samme prisanmodning, hvor du ændrer afsender- og modtagerplaceringer for hver test. API'en vil svare med samme foruddefinerede prissvar uanset adresseændringerne. Selvom værdierne muligvis ikke matcher, vil svarstrukturen simulere det, du vil modtage i det aktive miljø.
Da den virtualiserede service ikke rammer de aktive backend-systemkomponenter, er din integrationstest beskyttet mod backend-afhængigheder, mens du stadig får det passende svar.
Hvorfor er FedEx Sandbox virtualiseret?
I komplekse, indbyrdes afhængige systemer som FedEx er der desværre få tilfælde, hvor en afhængig ressource bliver utilgængelig, og systemtilgængeligheden påvirkes negativt. Når sådanne hændelser opstår, selvom de er fjerntliggende, kan det have en negativ indvirkning på din API-integrationstest. Der er andre begrænsninger i live-svar, der også kan begrænse rækkevidden af din integrationstest. Eksempler omfatter:
- Forsendelseskonto, der ikke har den påkrævede adgang til at teste visse specifikke scenarier.
- Begrænset tilgængelighed af testdata.
- Planlagt eller ikke-planlagt nedetid.
Hvordan kan du bruge det virtualiserede sandbox-svar?
- Lær API-dokumentation, slutpunkter og godkendelsesmetoden at kende. Det vil hjælpe dig med at designe effektive test.
- Download og sæt dig ind JSON API Collection, som findes under API-dokumentation.
- Vælg og afprøv transaktioner, der passer til dine brugerscenarier. For en konsekvent oplevelse skal du undgå at ændre dataanmodningen, så du modtager det virtualiserede svar.
- Bemærk, at ikke alle inputværdier vil påvirke svaret. Fokuser i stedet på at forstå, hvordan din anvendelse håndterer de konsekvente svar.
- Afprøv alle API'er for korrekt adfærd i henhold til dokumentationen. Medtag både positive og negative testcases.
- Brug den leverede negative testcase til at forstå, hvordan fejlmeldinger og statuskoder returneres. Dette vil hjælpe med at bestemme, hvordan din applikation vil håndtere fejl. Se JSON API Collection og testcases med præfikset "negativ".
Fordele ved virtualisering
- Mindre risiko for ressource-utilgængelighed.
- Mindre testdata-afhængighed.
- Hurtigere respons ved sammenligning med det live sandbox-svar.
- Det er ikke nødvendigt med explicit adgang på kontoniveau for Special Services.
- Problemfri integrationsoplevelse, der letter processen med test og certificering.
Ofte stillede spørgsmål
- Hvordan får jeg anmodningens data til at ramme det virtualiserede svar?
Hver API-dokumentation har den JSON API Collection, der leveres. Se API-kataloget, og åbn API-dokumentationen. Se afsnittet "JSON API Collection" i API-dokumentationen. Denne JSON API Collection gemmer alle dataanmodninger, som ville hente det virtualiserede svar. - Skal jeg bruge et token til at få adgang til det virtualiserede sandbox-svar?
Ja, tokengenereringen og -autorisationen kommer til at fungere, som de er, og du forventes at videregive tokenet for hver transaktion, der interagerer med den virtualiserede sandbox-service. - Hvordan ved jeg, om svaret returneres fra den virtualiserede service?
Det virtualiserede svar vil have nedenstående advarsel tilføjet som del af dataene.
- Hvorfor bliver min adresse i Rate and Transit Times API-anmodningsdata ikke valideret?
Adressevalidering er ikke en del af den logik, der henter et virtualiseret hastighedssvar. Kun landet valideres, så du kan angive en hvilken som helst værdi i resten af adressefelterne. - Virtualiseres alle API'er?
Kun følgende API'er er blevet virtualiseret indtil videre. Vi arbejder på at virtualisere resten af API-kapaciteterne.
Rate & Transit Times API | Virtualiseret |
Tracking API | Virtualiseret |
Freight LTL API – Pris- og afhentningstilgængelighed | Virtualiseret |
API til adressevalidering | Virtualiseret |
API til validering af postnummer | Virtualiseret |
API til anmodning om afhentning | Virtualiseret |
API til servicetilgængelighed | Virtualiseret |
Global Trade API | Virtualiseret |
API til lukning af Ground sidst på dagen | Virtualiseret |
Åben forsendelse API | Virtualiseret |
API til forsendelse | Virtualiseret |
API til FedEx-adressesøgning | Virtualiseret |