Authentication & Keys
OAuth2, API Key rotation, JWT scopes, and sandbox vs production environments.
Rate Limits & Quotas
Request throttling, burst policies, usage analytics, and quota escalation requests.
SDKs & Libraries
Official packages for Python, TypeScript, Go, Java, and cURL wrappers.
Webhooks & Events
Event subscriptions, signature verification, retry policies, and dead-letter queues.
Error Code Dictionary
HTTP 4xx/5xx mappings, Zenth-specific error codes, and resolution workflows.
Changelog & Deprecations
Version migration guides, sunset notices, and backward compatibility notes.
Troubleshooting & Known Issues
429 Too Many Requests & Burst Limits
If you're receiving
Common fix: Add
429 responses, your client has exceeded the configured rate limit for your tier. Check the X-RateLimit-Remaining header. Implement exponential backoff with jitter. Enterprise clients can request quota increases via the dashboard or PUT /v2/admin/quota.Common fix: Add
Retry-After header parsing to your request handler.
Webhook Signature Verification Failed
Ensure you're using the correct signing secret from your webhook endpoint configuration. The signature is generated using HMAC-SHA256 over the raw request body and timestamp. Verify that your server isn't URL-decoding the body before hashing. Use our official SDK verification method or refer to the webhook security guide.
Sandbox vs Production Payload Differences
Sandbox responses include a
"environment": "sandbox" flag and may omit sensitive PII fields. ID prefixes differ (e.g., sb_live_ vs prod_). Ensure your validation logic accounts for these structural differences. Use the ?env=simulate query parameter to test production-like flows safely.
Connection Timeouts on Large Payloads
Requests exceeding 10MB may timeout if not chunked or compressed. Enable
Accept-Encoding: gzip and use multipart/form-data for file uploads. For bulk operations, switch to the asynchronous /v2/batch endpoint which returns a job ID for polling.
Request Diagnostics
bash
API Diagnostics Template
curl -X GET https://api.aevumzenth.com/v2/diagnostics \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Request-ID: debug-001" \
-H "Content-Type: application/json"
💡 Pro Tip: Always include
X-Request-ID in headers. It links your call to our trace logs and drastically reduces support ticket resolution time.
Support Channels
Open a Support Request