Sandbox Environment

​

What is the Sandbox Environment?

The Sandbox Environment is a testing and development environment that provides realistic device simulations without requiring real OEM credentials or physical devices. It allows you to build and test your integration safely before moving to production.

​

Key Benefits

​

How It Works

Sandbox devices simulate realistic behavior patterns based on UTC time:

​

Vehicles

• Morning (6-9am UTC): Likely plugged in, charging or fully charged (80-95% battery)
• Daytime (9am-5pm UTC): Likely unplugged, battery level decreases
• Evening (5-9pm UTC): May be plugged in for overnight charging
• Night (9pm-6am UTC): Plugged in, charging overnight

​

Batteries

• Morning (6-9am UTC): Discharging for morning load
• Midday (9am-3pm UTC): Charging from solar production
• Evening (3-9pm UTC): Discharging for peak usage
• Night (9pm-6am UTC): Idle or slow charging

​

Solar Inverters

• Night (6pm-6am UTC): No production
• Morning (6-9am UTC): Ramping up production
• Midday (9am-3pm UTC): Peak production
• Afternoon (3-6pm UTC): Declining production

​

Use Cases

​

Development & Testing

Build and test your integration without real devices. Verify API calls, webhook handling, and error scenarios safely before connecting real customer devices.

​

CI/CD Pipelines

Include integration tests in your CI/CD pipeline using sandbox devices. Test new features and changes automatically without manual device setup.

​

Demo Environments

Create demo environments for sales and marketing. Show your product working with simulated devices that behave realistically without needing real customer connections.

​

Learning & Prototyping

Learn the API and prototype new features without the complexity of managing real device connections and credentials.

​

Sandbox vs Live

​

Next Steps