Featured Webinar: Simplify Compliance Workflows With New C/C++test 2024.2 & AI-Driven Automation Watch Now

Create Low-Cost Sandbox Environments With API Simulation

Headshot of Grigori Trofimov, Senior Solution Architect at Parasoft
December 17, 2020
6 min read

Development sandboxes may be the key to completing a sale and satisfying your customers if you are in the business of APIs. But how do you create a low-cost sandbox environment with API simulation? This post covers how you can get started.

When selling software, particularly complex enterprise products, we understand that a sale doesn’t end when the cash hits the bank. Post-sales support is just as important as pre-sales for customer experience. In fact, customer success is what drives revenue and there is ample data to show it. Khalid Saleh of Invesp created a fantastic infographic on this. Here are some key takeaways:

  • Acquiring a new customer is five times as expensive as retaining an existing customer.
  • The probability of selling to existing customers is 60 – 70%, while the probability of selling to a new prospect is 5 – 20%.
  • Increasing customer retention rates by 5% increases profits by 25 – 95%.

Customer Success Is Critical to Business

Basically, customer success is everything in sales. It means you have a good product. It means you’re getting free leads, shorter sales cycles, and higher conversion rates.

Everything Starts With Onboarding

What is a key way for platform providers to increase customer success? Well, for platforms, tools, and service providers, it means that they really need to focus on onboarding. Onboarding customers to your platform means getting customers up to speed with your services so they can use your tools like pros.

It also means teaching your users how to use your APIs so they can build their own solutions in applications. A good onboarding process needs to be transparent and seamless. Developers don’t want to put their “unproven” code into production. To build these integrations effectively, developers need a safe development environment to test and get familiar with your product — a sandbox environment where they can put unproven code and try it out before it goes into production.

Develop Low-Cost Sandbox Environments for Customer Onboarding

If you’re in the business of selling APIs, the key to sales is an efficient and compelling way to prove value to your customers. Development sandboxes are ideal for this, but what are the requirements for success?

  • Well built
  • Well documented
  • Readily available
  • Secure

Well Built

Your customers don’t want to see unexpected bugs, inconsistent or unrealistic behavior. The expectation is that your sandbox environment undergoes the same rigorous testing as your production and QA environments do.

Well Documented

APIs are not simple, and developers need to get up to speed quickly in order to get familiar with your product. A well-documented API and sandbox environment is critical. Swagger and OpenAPI have become necessary in terms of documenting and defining APIs and services. Equally important is validating that the behaviors of those APIs adhere to the schema as defined in the published definitions.

Readily Available

Your customers are eager to get started, and not having access to their newly bought product is a significant blocker for your customer’s development and test work. Any amount of downtime can contribute to a negative experience.

Secure

In the world of PCI DSS and GDPR compliance, security can mean a lot of different things, but in the context of API sandboxes, test data rather than real customer data should be used exclusively. A sandbox should never have access to customer data, and in general, applications should be sufficiently isolated from each other.

Again, a good sandbox is crucial to customer satisfaction. There’s a reason why there are annual DevPortal awards. Organizations that put a lot of effort into good API product experience get recognition.

Why Low-Cost Sandbox Environments Are Difficult

Sandboxes are useful but there’s a catch. You can’t simply set up a bunch of sandbox environments and expect it to work. It’s not that simple. APIs don’t do anything by themselves and require orchestration that integrates with multiple internal and external services and backend systems and provides data.

Setting up a sandbox environment for a single API means standing up the whole environment, not just a single service, and this can be difficult.

4 Key Challenges of Low-Cost Sandbox Environments

There are four key challenges for creating development sandboxes which are conveniently mapped to the above sandbox requirements – the ABCDs of sandboxes:

  • Availability
  • Behavior
  • Cost
  • Data

Availability

Simply put, a sandbox environment must be stable to be available and provide a positive customer experience. Organizations already struggle with their own QA environment. Maintaining and delivering 100% uptime is unrealistic and downtime leads to a bad user experience.

Behavior

A sandbox environment should be a faithful representation of the real system. Initially, static responses are good for simple requests, but complex operations require some change of state and dynamic logic. What happens when a customer wants to performance or negative path testing? Complicated test scenarios can be difficult to simulate in a complex system.

Cost

Maintaining a test environment isn’t free, nor are external dependencies. The more users, the more those costs will scale. Understanding those costs and understanding the usage becomes crucial to determining the pricing or charge-back model you may want to implement for your end users.

Data

Test data in a test environment is a lot like a coin counting machine. A coin machine takes your coins and counts them. It returns some amount of cash, but if multiple people are using the machine at the same time, nobody knows which cash is theirs. The same thing happens with shared test data in shared environments. Once data is consumed, it can’t be used for other tests unless any changes are reverted in some way, which is complex and time-consuming.

These are challenges we see here that mirror what we see in many organizations that are also looking to improve their testing and test automation practices. And frankly, the solution is rather similar.

Service Virtualization Checks the Necessary Boxes

Service virtualization is a method to emulate the behavior of specific components (virtualize these dependencies) in heterogeneous component-based applications, such as:

  • API-driven applications
  • Cloud-based applications
  • Service-oriented architectures

It’s a powerful solution when it comes to API simulation by stabilizing test environments and enabling rapid agile development. The power service virtualization brings to API and SOA testing makes it a good choice for low-cost sandbox servers.

Virtualization provides the ability:

  • Create complex environments on demand.
  • Build realistic services with controlled individual service behavior.
  • Keep track of usage across all your sandboxes.
  • Create and manipulate data for each unique API and for each individual user.

As you can see, service virtualization really checks the boxes.

Graphic showing Service Virtualization checkboxes
Figure 1: Service Virtualization checkboxes for low-cost sandbox environments.

Service Virtualization Is the Sweet Spot for Sandbox Environments

In the engagements Parasoft has done, we have observed an 80:20 rule. Some environments only require simple static responses to API calls so simple mocks are enough. Modern API gateways have very good ways to store these predefined answers, such as when the mocks are built in. If that is really all that’s needed, then service virtualization might be overkill.

On the other end of the spectrum, the environment needs to be very close to realistic. API calls require real data or actual updates to backend systems. The question arises as to whether it’s cost effective to replicate so much of the real system as virtual servers. In these cases, it may be better to use the real system or a clone.

However, in about 80% of the cases, the requirements are somewhere in between these extremes. Service virtualization is sufficient to build realistic simulations for testing and validation scenarios.

Graph showing 10% static responses, 80% service virtualization realistic testing/validation and 10% workflows that require real backend systems
Figure 2: Service virtualization suits most of the needs of low-cost sandbox environments.

How Are Customers Using Their Sandboxes?

The fundamental goal of a sandbox is to validate APIs and services, usually third-party products, before integrating into your production system. However, there’s a scale of maturity of usage that we see in practices of increasing sophistication aided by tools and service virtualization.

  • Basic system administration to verify that services are running to detect any exceptions that arise and to ensure the server has enough capacity.
  • Validation to ensure correct messages are being sent and the correct workflows are being respected.
  • Certification of B2B partners within your sandbox environment and eventual monetization.
  • Analysis and reporting for monetization for usage-based billing.

Parasoft Virtualize provides support for these use cases along with the monitoring, analysis, and reporting required for more sophisticated sandbox usage.

Screen capture of Parasoft Virtualize sandbox usage analysis and reporting
Figure 3: Sandbox usage analysis and reporting provided by Parasoft Virtualize.

Summary

An API sandbox enables a smooth onboarding experience for API and service products with the aim of improving customer success. Service virtualization reduces the complexity, cost, and risk of API sandboxes. Sandboxes need near-real services and Parasoft Virtualize offers a rich feature set to replicate this behavior quickly and reliably.

Sandboxes need to be cost efficient and service virtualization offers the sweet spot solution for creating a realistic environment. With that in mind, Parasoft Virtualize provides scalability and security to API sandboxes and offers a variety of deployment models and a modular-based approach to service virtualization and data management.

As your sophistication in sandbox development increases, service virtualization is there to scale with you and enable the next level of maturity.

See how Parasoft Virtualize reduces the complexity, cost, and risk of API sandboxes.