API Sandbox-virtualisatie - Toelichting voor klanten

Wat is Sandbox-virtualisatie?

API Sandbox-virtualisatie is een service die het gedrag van een live sandbox-exemplaar nabootst. Onze gevirtualiseerde service biedt een consistente ervaring waarbij de reacties die u ontvangt vooraf gedefinieerd zijn en niet altijd variëren op basis van de specifieke invoerwaarden die u opgeeft.

Hieronder vindt u een voorbeeld. Stel dat u meerdere oproepen doet met dezelfde prijsaanvraag, maar per test past u de verzender en de locatie van de ontvanger aan. De API reageert met hetzelfde vooraf gedefinieerde tarief, ongeacht de adreswijzigingen. Ondanks dat de waarden niet overeenkomen, is de structuur van de reactie hetzelfde als de reactie die u in de live omgeving ontvangt.

Omdat de gevirtualiseerde service de live backendsysteemcomponenten niet bereikt, zijn uw integratietests niet afhankelijk van de backend, maar krijgt u toch de juiste reactie.

Waarom is FedEx Sandbox gevirtualiseerd?

In complexe, onderling afhankelijke systemen zoals FedEx zijn er helaas gevallen wanneer een afhankelijk middel niet langer beschikbaar is en de beschikbaarheid van het systeem daar last van heeft. Als zo'n situatie zich voordoet, ook al is het op afstand, kan dat een negatieve invloed hebben op uw API-integratietests. Er zijn andere beperkingen in live situaties die ook de reikwijdte van uw integratietests kunnen beperken. Voorbeelden zijn

• Verzendaccount heeft geen vereiste toegang om een specifiek scenario te testen.
• Beperkte hoeveelheid testgegevens.
• Geplande of ongeplande systeemuitval.

Hoe kunt u een gevirtualiseerd Sandbox-exemplaar gebruiken?

• Zorg ervoor dat u vertrouwd raakt met de API-documentatie, eindpunten en verificatiemethoden. Dit komt van pas bij het ontwikkelen van effectieve tests.
• Download de JSON API-verzameling uit de API-documentatie en raak ermee vertrouwd.
• Kies en test voorbeeldtransacties die overeenkomen met uw gebruiksscenario's. Vermijd voor een consistente ervaring het wijzigen van de structuur van de nettolading voor aanvragen, zodat u de gevirtualiseerde reacties ontvangt.
• Houd er rekening mee dat niet alle invoerwaarden de reactie beïnvloeden. Concentreer u in plaats daarvan op hoe uw applicatie reageert op de consistente reacties.
• Test alle API's op juist gedrag volgens de documentatie. Neem zowel positieve als negatieve testgevallen hierin mee.
• Gebruik de verstrekte negatieve testgevallen om foutberichten en statuscodes op de juiste manier te lezen. Dit helpt bij het bepalen van hoe uw applicatie omgaat met fouten. Raadpleeg de JSON API-verzameling en testgevallen met het voorvoegsel 'Negatief'.

Voordelen van virtualisatie

• Meer kans op beschikbare middelen.
• Minder afhankelijk van testgegevens.
• Snellere reacties in vergelijking met het live Sandbox-exemplaar.
• Geen expliciete toegang op accountniveau vereist voor special services.
• Naadloze integratie-ervaring vergemakkelijkt het proces van testen en certificeren.

Veelgestelde vragen

1. Hoe zorg ik ervoor dat de nettolading voor aanvragen de gevirtualiseerde reacties bereikt?
   Alle API-documentatie bevat de JSON API-verzameling. Ga naar API-catalogus en open de documentatie voor API. Zoek het gedeelte JSON API-verzameling in de API-documentatie. Deze JSON API-verzameling bevat alle nettoladingen voor aanvragen die de gevirtualiseerde reacties oproepen.
2. Heb ik de token nodig om toegang te krijgen tot het gevirtualiseerde Sandbox-exemplaar?
   Ja, de tokengeneratie en -authenticatie blijven werken op dezelfde manier en er wordt van u verwacht dat u de tokenauthenticatie doorloopt voor elke transactie met de gevirtualiseerde Sandbox-service.
3. Hoe weet ik of de reactie komt van de gevirtualiseerde service?
   De gevirtualiseerde reactie bevat onderstaande waarschuwing als onderdeel van de nettolading.
   
   
4. Waarom wordt mijn adres in de nettolading voor aanvragen niet gevalideerd in de API voor tarief en transittijden?
   Adresvalidatie is geen onderdeel van de logica waarvan een gevirtualiseerde tariefreactie afkomstig is. Alleen uw land wordt gevalideerd, zodat u elke waarde in de overige adresvelden kunt invoeren.
5. Worden alle API's gevirtualiseerd?
   Alleen de volgende API's zijn tot nu toe gevirtualiseerd. Er wordt gewerkt aan de virtualisatie van de overige API-mogelijkheden.