OpenAPI Documentation
OpenAPI Documentation
Integration overview
The Open API provides wallet balance queries, dynamic proxy management, and static proxy management. It is designed for requests made by your server-side application.
API capabilities
| Capability | Description |
|---|---|
| Wallet | Query the USD balance available for purchases |
| Dynamic traffic | List products, purchase traffic, and query balances, daily usage, batches, and orders |
| Dynamic regions | Query available region codes by country, province/state, and city |
| Dynamic sub-accounts | Create and query sub-accounts, set traffic limits, enable or disable accounts, and generate connection credentials |
| Static proxies | Query regions, inventory, and quotes; purchase proxies, query resources, and renew them |
| Callback notifications | Send one notification when a static proxy purchase or renewal order reaches a terminal state |
API keys are created, renamed, enabled, disabled, and revoked through the web console. These operations are outside the scope of the business APIs in this documentation.
Service endpoints
| Environment | Base URL | Purpose |
|---|---|---|
| Test | https://api-test.puraroute.com/gin |
Development and integration testing |
| Production | https://api.puraroute.com/gin |
Production business requests |
Append the request path from each API article to the Base URL. For example:
https://api-test.puraroute.com/gin/open-api/v1/wallet/balance
Recommended integration sequence
- Create an API key for the test environment in the web console.
- Follow the Quickstart to verify authentication and network connectivity.
- Choose either the dynamic proxy or static proxy workflow based on your business needs.
- Implement error-code handling, timeouts, duplicate-submission protection, and sensitive-data protection.
- Go live with a production API key and the production Base URL.
Data security
API keys, proxy account names, proxy passwords, and complete connection credentials are sensitive. Do not place them in browser code, public logs, error pages, monitoring labels, or support ticket bodies.