Troubleshooting CurlDotNet

Quick access to troubleshooting guides for common issues with CurlDotNet.

🔧 Troubleshooting by Category

Connection Issues

• Network unreachable
• Connection refused
• DNS resolution failures
• Proxy configuration

Authentication Problems

• 401 Unauthorized
• Invalid API keys
• Token expiration
• OAuth issues

SSL/TLS Errors

• Certificate validation
• Self-signed certificates
• TLS version mismatches
• Cipher suite problems

Timeout Issues

• Operation timeouts
• Connection timeouts
• Read timeouts
• Large file downloads

HTTP Errors

• 404 Not Found
• 500 Internal Server Error
• Rate limiting (429)
• Bad requests (400)

🚀 Quick Fixes

Enable Verbose Mode

// See what's happening under the hood
var result = await Curl.ExecuteAsync("curl -v https://api.example.com");
Console.WriteLine(result.VerboseOutput);

Skip SSL Verification (Dev Only!)

// WARNING: Only for development
var result = await Curl.ExecuteAsync("curl -k https://localhost:5001");

Increase Timeout

// Give slow servers more time
var result = await Curl.ExecuteAsync("curl --max-time 60 https://slow-api.example.com");

Use Proxy

// Route through corporate proxy
var result = await Curl.ExecuteAsync("curl -x proxy:8080 https://api.example.com");

📋 Diagnostic Checklist

Before reporting an issue, check:

• URL is correct and accessible
• Network connectivity is working
• Authentication credentials are valid
• SSL certificates are valid
• Firewall/proxy settings are correct
• Request format matches API documentation

🔍 Debug Tools

1. Verbose Output

Get detailed information about the request:

var result = await Curl.ExecuteAsync("curl -v https://api.example.com");

2. Trace Network

See exact data sent/received:

var result = await Curl.ExecuteAsync("curl --trace - https://api.example.com");

3. Show Headers Only

Debug response headers:

var result = await Curl.ExecuteAsync("curl -I https://api.example.com");

📚 Documentation

• Complete Troubleshooting Guide
• Common Issues
• Exception Reference
• API Documentation

💬 Getting Help

1. Check the documentation above
2. Search existing issues
3. Ask on Stack Overflow
4. Create a new issue

---

CurlDotNet Troubleshooting Guide