Documentation
Introduction
Welcome to the MeshPrivacy API documentation. Our platform provides a standardized interface for interacting with complex WAF challenges and bot protection systems programmatically.
Welcome to the MeshPrivacy API documentation. Our platform provides a standardized interface for interacting with complex WAF challenges and bot protection systems programmatically.
All interactions with MeshPrivacy follow an asynchronous Task Lifecycle to ensure reliability and scalability.
Submit your request (URL, service type, payload) via POST /tasks/submit.
The system processes your request. Poll the /tasks/result endpoint.
Receive the solution token (e.g., cookie, captcha key) to use in your client.
# 1. Submit Task
curl -X POST https://api.meshprivacy.com/v1/tasks/submit \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"service": "akamai",
"url": "https://target.com"
}'
# Response:
# { "success": true, "task_id": "..." }
# 2. Poll Result
curl https://api.meshprivacy.com/v1/tasks/result/... \
-H "x-api-key: YOUR_API_KEY"MeshPrivacy uses API keys to allow access to the API. You can register a new API key at our Settings Page.
Authentication to the API is performed via the x-api-key header.
curl "https://api.meshprivacy.com/v1/..." \
-H "x-api-key: YOUR_API_KEY"| Code | Description |
|---|---|
| 400 | Bad Request - Missing required fields. |
| 401 | Unauthorized - Invalid or missing API key. |
| 402 | Payment Required - Insufficient credits. |
| 429 | Too Many Requests - Rate limit exceeded. |
| 500 | Internal Error - Something went wrong. |