Troubleshooting

Causes

• Invalid JSON format
• Missing required fields
• Endpoint URL mismatch

Solutions

• Validate JSON format
• Check required fields in API docs
• Verify endpoint URL

Causes

• Missing or empty Authorization header
• Invalid API key format (should be tm_test_xxx... or tm_live_xxx...)
• Wrong API key for this endpoint
• API key has been deactivated by the endpoint owner

Solutions

• Include Authorization header (e.g., Bearer tm_test_xxx...)
• Use tm_test_xxx... for Sandbox, tm_live_xxx... for Production
• Regenerate key if needed
• Contact the endpoint owner to reactivate your API key

Causes

• Endpoint is deactivated
• Subscription expired or monthly quota exceeded
• Production not deployed (tm_live_ key used)

Solutions

• Verify endpoint is active
• Check subscription status
• Deploy to Production if using tm_live_ key

Causes

• Missing or wrong Content-Type header
• Content-Type must be application/json

Solutions

• Add header: Content-Type: application/json

Causes

• Monthly request limit exceeded

Solutions

• Upgrade plan or wait for monthly reset
• Monitor usage in dashboard

Includes 500 (Internal Server Error), 502 (Bad Gateway), 503 (Service Unavailable), etc.

Causes

• Temporary server issue
• Upstream service (database) temporarily unavailable
• Service temporarily overloaded or under maintenance

Solutions

• Implement retry with exponential backoff (e.g., 1s → 2s → 4s, max 3 attempts)
• Check service status if errors persist
• Contact support if issue persists: contact@3minapi.com
• Note: 5xx means the request was not received. Once you get 202 Accepted, data processing is guaranteed.

• Verify webhook URL is correct
• Use HTTP or HTTPS URL
• Endpoint must be publicly accessible
• Check webhook status in logs

• Return 2xx status code for success
• Respond within 30 seconds
• System retries up to 3 times automatically
• Webhook retries may delay data processing (up to ~3 seconds)