Virtualizace sandboxu rozhraní API – Informace pro zákazníky

Co je virtualizace sandboxu?

Virtualizace sandboxu rozhraní API je služba, která simuluje chování živé instance sandboxu. Naše virtualizovaná služba poskytuje konzistentní prostředí, kdy je odpověď, kterou obdržíte, předem definovaná a nemusí se vždy lišit v závislosti na konkrétních zadaných vstupních hodnotách.

Zde je příklad. Předpokládejme, že provedete několik volání se stejným požadavkem na ceny a při každém testu změníte umístění odesílatele a příjemce. Rozhraní API bez ohledu na změny adresy vrátí stejnou předdefinovanou odpověď s informacemi o cenách. Přestože se hodnoty nemusí shodovat, struktura odpovědi simuluje odpověď, kterou byste obdrželi v živém prostředí.

Vzhledem k tomu, že virtualizovaná služba nekomunikuje s komponentami živého administrativního systému, je testování integrace chráněno před závislostmi na administraci, přičemž stále obdržíte odpovídající odpověď.

Proč je sandbox společnosti FedEx virtualizovaný?

Ve složitém, vzájemně závislém systému, jako je systém společnosti FedEx, bohužel občas dochází k případům, kdy se závislý zdroj stane nedostupným, a tím utrpí dostupnost systému. Pokud k takovým incidentům dojde, i když jsou vzdálené, může to mít negativní dopad na testování integrace rozhraní API. V živých instancích existují další omezení, která rovněž mohou omezit rozsah testování integrace. Mezi příklady patří:

• Účet pro zasílání nemá požadovaný přístup k testování určitého konkrétního scénáře.
• Omezená dostupnost testovacích dat.
• Plánovaný nebo neplánovaný výpadek systému.

Jak lze použít instanci virtualizovaného sandboxu?

• Seznamte se s dokumentací k rozhraní API, koncovými body a metodou ověřování. Pomůže vám to při návrhu efektivních testů.
• Stáhněte si kolekci rozhraní JSON API uvedenou v dokumentaci k rozhraní API a seznamte se s ní.
• Vyberte si a otestujte ukázkové transakce, které odpovídají vašim scénářům použití. V zájmu zajištění konzistence neměňte strukturu datové části požadavku, abyste získali virtualizovanou odpověď.
• Upozorňujeme, že ne všechny vstupní hodnoty ovlivní odpověď. Místo toho se zaměřte na to, jak vaše aplikace zpracovává konzistentní odpovědi.
• Podle dokumentace otestujte správné chování všech rozhraní API. Zahrňte pozitivní i negativní testovací případy.
• Uvedené negativní testovací případy vám pomohou pochopit, jak se vrací chybové zprávy a stavové kódy. To vám pomůže určit, jakým způsobem by vaše aplikace měla zpracovávat chyby. Projděte si kolekci rozhraní JSON API a testovací případy s předponou „Negativní“.

Výhody virtualizace:

• Menší pravděpodobnost nedostupnosti zdrojů
• Menší závislost na testovacích datech
• Rychlejší odezva v porovnání s živou instancí sandboxu
• Speciální služby nevyžadují explicitní přístup na úrovni účtu
• Bezproblémová integrace usnadňující proces testování a certifikace

Často kladené dotazy

1. Jak můžu na datovou část požadavku získat virtualizovanou odpověď?
   Každá dokumentace k rozhraní API obsahuje kolekci rozhraní JSON API. Přejděte do katalogu rozhraní API a otevřete dokumentaci ke konkrétnímu rozhraní API. V dokumentaci k rozhraní API si projděte část Kolekce rozhraní JSON API. V této kolekci rozhraní JSON API jsou uloženy všechny datové části požadavků, které načtou virtualizovanou odpověď.
2. Potřebuji pro přístup k instanci virtualizovaného sandboxu získat token?
   Ano, generování a autorizace tokenů fungují tak, jak jsou, a token je třeba předat pro každou transakci, která komunikuje se službou virtualizovaného sandboxu.
3. Jak poznám, jestli vrácená odpověď pochází z virtualizované služby?
   Součástí datové části virtualizované odpovědi by bylo níže uvedené upozornění.
   
   
4. Proč se v rozhraní API pro ceny a doby přepravy neověřuje moje adresa v datové části požadavku?
   Ověřování adresy není součástí logiky, která odvozuje virtualizovanou odpověď s informacemi o cenách. Ověřuje se pouze země, takže do ostatních polí adresy můžete zadat libovolnou hodnotu.
5. Jsou všechna rozhraní API virtualizovaná?
   K dnešnímu datu byla virtualizována pouze následující rozhraní API. Na virtualizaci zbývajících funkcí rozhraní API se pracuje.