Comprehensive reference for Aevum News API, authentication, and system error responses. Use the filters below to quickly locate troubleshooting guidance.
| Error Code | Category | Description | Recommended Action |
|---|---|---|---|
401 |
Authentication | Unauthorized request. Missing or invalid API key provided. | Verify your API credentials in the dashboard. Ensure the `Authorization: Bearer <token>` header is correctly formatted. |
AUTH_001 |
Authentication | Token expired or revoked. | Refresh your access token using the `/auth/refresh` endpoint. Tokens expire after 24 hours. |
API_001 |
API Specific | Invalid parameter format in request payload. | Check schema documentation. Ensure date fields use ISO 8601 format and pagination uses `limit`/`offset`. |
API_004 |
API Specific | Requested resource exceeds your subscription tier limits. | Upgrade to Pro or Enterprise plan, or reduce request scope (e.g., narrow date ranges). |
429 |
Rate Limits | Too Many Requests. You've exceeded your allowed request quota. | Implement exponential backoff. Check `X-RateLimit-Reset` header for cooldown time. |
RATE_002 |
Rate Limits | Burst limit exceeded. Sudden spike in concurrent requests. | Throttle outgoing requests. Use webhook subscriptions instead of polling for real-time updates. |
400 |
HTTP Status | Bad Request. Malformed syntax or invalid content type. | Validate JSON structure. Ensure `Content-Type: application/json` is set. |
403 |
HTTP Status | Forbidden. Valid credentials but insufficient permissions. | Verify API key scopes in dashboard. Some endpoints require `read` or `admin` privileges. |
404 |
HTTP Status | Not Found. Endpoint or requested article ID does not exist. | Verify URL path and resource IDs. Check for typos in endpoint slugs. |
500 |
System | Internal Server Error. Unhandled exception on our end. | Retry with delay. If persistent, open a support ticket with the correlation ID from the response header. |
502 |
System | Bad Gateway. Upstream data service temporarily unreachable. | Wait 30-60 seconds and retry. Status updates available at `status.aevum.news`. |
503 |
System | Service Unavailable. Scheduled maintenance or overload. | Check maintenance windows in developer docs. Retry after `Retry-After` header duration. |
API_009 |
API Specific | Webhook delivery failed repeatedly. | Verify your endpoint returns `2xx`. Check firewall rules blocking Aevum IPs. Use webhook test tool. |