Overview
Authentication, rate limits, and error handling for the PixelShield API.
The PixelShield API lets you manage domains, backends, firewall rules, and analytics programmatically. Everything you can do in the dashboard, you can do through the API.
Base URL
https://api.pixelshield.net/apiAuthentication
Generate an API key from Dashboard > Settings > API Keys. Include it in the Authorization header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.pixelshield.net/api/domainsRate limits
API requests are limited to 60 per minute per API key. Every response includes rate limit headers:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1700000000If you hit the limit, you'll get a 429 response. Wait until the reset timestamp before retrying.
Error responses
All errors return JSON with a message field:
{"message": "Domain not found"}| Status | Meaning |
|---|---|
400 | Bad request — check your parameters |
401 | Unauthorized — missing or invalid API key |
403 | Forbidden — you don't own this resource |
404 | Not found — check the resource ID |
429 | Rate limited — wait and retry |
500 | Server error — contact support@pixelshield.net |