Sandbox / Testnet
AdPriva provides a sandbox environment and testnet so developers, publishers and auditors can test integrations before moving to production.
This lets you validate tag installation, proof flows and API calls in a safe, risk-free environment.
Why Use the Sandbox
- Safe Testing → No production impact; proofs stay sandbox-only.
- Faster Iteration → Debug proofs, dashboards and APIs without live impact.
- Team Onboarding → Perfect for demos, workshops and evaluations.
What’s Included
- Test Publisher Accounts → Register sites/apps instantly, no approvals.
- Sandbox Tag / SDK → Generates fake but verifiable proofs.
- Testnet Explorer → Inspect ViewProofs, ClickProofs and ConversionProofs.
- API Access → Same endpoints and proof formats as production (/proofs, /verify, /snapshots) under the sandbox namespace.
Getting Started
- Sign Up → Request a sandbox developer account.
- Obtain Keys → Generate API keys (prefixed with test_…).
- Integrate Tag/SDK → Add sandbox Tag/SDK into your staging site or app.
- Generate Test Proofs → Trigger page views and clicks to produce sandbox proofs.
- Validate Proofs → Check receipts in the Testnet Explorer.
- Migrate to Production → Swap sandbox-api.adpriva.com for api.adpriva.com and update keys.
API Base URLs
# Sandbox / Testnet
https://sandbox-api.adpriva.com/v1
# Production
https://api.adpriva.com/v1
Limitations
- Proofs are valid in sandbox but not anchored on mainnet.
- Logs reset periodically for clean testing.
- Sandbox scale limited → not for benchmarking.
The Sandbox/Testnet is your playground for experimentation making migration to production seamless, fast and risk-free.
{% @mermaid/diagram content="flowchart LR
A\[Sandbox Account] --> B\[Generate test\_ API Keys]
B --> C\[Integrate Sandbox Tag/SDK]
C --> D\[Generate Test Proofs]
D --> E\[Validate Proofs in Testnet Explorer]
E --> F\[Migrate to Production: swap API base + keys]
F --> G\[Live Production Proofs]" %}