🌐 Network Error
What it means & how to fix it
What is this error?
Unable to establish a connection to the service
Common errors: ECONNREFUSED, ENOTFOUND, ETIMEDOUT, ERR_NAME_NOT_RESOLVED. These indicate client-side network issues.
Common Causes
•
No internet connectivity
•
Firewall or proxy blocking the connection
•
DNS resolution failures
•
Network routing issues
•
VPN or network configuration problems
•
ISP or local network outages
✓ How to Fix It
- Check your internet connection is working
- Try accessing the service from a different network
- Disable VPN or proxy temporarily to test
- Flush DNS cache (ipconfig /flushdns on Windows, sudo dscacheutil -flushcache on Mac)
- Check firewall settings and whitelist the service domain
- Restart your router or modem
- Contact your ISP if the problem persists
💡 Prevention Tips
Implement proper error handling: Always catch and log errors with detailed context (timestamps, request IDs, parameters).
Use retry logic: Implement exponential backoff for transient errors. Don't retry immediately—wait progressively longer between attempts.
Monitor your usage: Set up alerts for quota limits, error rates, and unusual patterns. Catch issues before they impact users.
Stay updated: Subscribe to service status notifications and follow official channels for maintenance announcements.
Frequently Asked Questions
Is this error on my side or the service's side?
Check the "Common Causes" section above. Network errors, authentication failures, and connection issues are often client-side. Server errors, maintenance, and service unavailability are provider-side. Use our status monitoring dashboard to see if others are experiencing the same problem.
How long will it take to resolve?
Resolution time varies by error type. Client-side issues (authentication, network) can be fixed immediately by following the solutions above. Server-side issues depend on the provider's response time—typically minutes to hours for minor issues, longer for major outages.
Should I keep retrying or wait?
Use exponential backoff: wait 1s, then 2s, 4s, 8s, etc. between retries. Don't retry immediately or in a tight loop—you'll waste resources and may get rate limited. For rate limit errors specifically, wait for the reset time indicated in response headers.
Where can I report persistent errors?
First, check if the service has reported issues on our status pages. If not, report directly to the service provider's support team with error details (timestamps, request IDs, exact error messages). You can also report on our platform to alert the community.
What information should I include when reporting an error?
Include: exact error message or code, timestamp, request ID (if provided), HTTP status code, endpoint URL, approximate payload size, and any recent changes to your integration. This helps support teams diagnose issues quickly.
Related Resources