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/api

Authentication

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/domains

Rate 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: 1700000000

If 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"}
StatusMeaning
400Bad request — check your parameters
401Unauthorized — missing or invalid API key
403Forbidden — you don't own this resource
404Not found — check the resource ID
429Rate limited — wait and retry
500Server error — contact support@pixelshield.net

On this page