Environments
Zentake has two environments: production and sandbox. Both are
served from the same base URL, https://api.app.zentake.com/v2, and the
same endpoints. Which environment a request hits is determined entirely by
which credentials you send, not by the URL.
Production vs. sandbox
| Production | Sandbox | |
|---|---|---|
| Purpose | Live data | Testing only |
| Data | Real patient data | Isolated test data |
| Messages | Real SMS / emails sent | Real SMS / emails sent, within sandbox caps |
| Limits | Based on your plan | 60 req/min, 500 req/day, 5 SMS/day, 10 emails/day, 100 patients max, 20 forms max |
| Credentials | Production X-API-KEY / X-API-SECRET | Sandbox X-API-KEY / X-API-SECRET (different values) |
See Sandbox for what's testing-specific about the sandbox environment, and Rate limits for the full limits breakdown.
Switching environments
Environment is selected by credentials, not configuration:
- Send your production
X-API-KEY/X-API-SECRETto hit production. - Send your sandbox
X-API-KEY/X-API-SECRETto hit sandbox.
Both credential pairs are available from Settings > API Credentials in the Zentake dashboard, toggle the environment switch there to see the pair for that environment.
Because both environments share https://api.app.zentake.com/v2, a typo
that swaps in the wrong credentials won't 404. It will authenticate
against the other environment. Always check the response header below
if you need to be sure which environment you're talking to.
Identifying the environment from a response
Every response, success or error, includes:
X-Zentake-Environment: sandbox | production
Check this header in integration tests or logging if you want a belt-and-suspenders confirmation that a request landed where you expected.