Troubleshooting Guide

Solutions for common issues and error messages

Common Issues

"Invalid API Key" Error

Authentication failures when making API calls

Possible Causes:

  • API key is missing or incorrect
  • API key has been revoked or expired
  • Incorrect header format
  • Environment variable not set properly

Solutions:

  1. Verify API key in your configuration file
  2. Check environment variables are set correctly
  3. Regenerate API key in dashboard if needed
  4. Ensure header is formatted as X-Api-Key: your_key

# Test API key validity

curl -H "X-Api-Key: your_key" \

https://api.killswitchguardian.com/v1/status

Network Connectivity Issues

Application cannot reach KillSwitch Guardian API

Possible Causes:

  • Firewall blocking outgoing connections
  • DNS resolution problems
  • Proxy configuration issues
  • Service outage (check status page)

Solutions:

  1. Test connectivity from your environment
  2. Check firewall rules allow outbound HTTPS
  3. Verify DNS can resolve api.killswitchguardian.com
  4. Configure proxy settings if required

# Test connectivity

ping api.killswitchguardian.com

telnet api.killswitchguardian.com 443

# Test with curl

curl -I https://api.killswitchguardian.com/v1/status

Performance and Timeout Issues

Slow response times or request timeouts

Possible Causes:

  • Network latency
  • High TTL causing infrequent checks
  • Application blocking on startup
  • Rate limiting

Solutions:

  1. Increase cache TTL for better performance
  2. Implement asynchronous checking
  3. Use fail-open mode during timeouts
  4. Monitor rate limit headers

// Async implementation example

public async Task CheckLicenseAsync()

{

using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));

return await killSwitch.CheckAsync(cts.Token);

}

Error Code Reference

Error Code HTTP Status Description Solution
AUTH_001 401 Invalid API key Verify API key in dashboard
CUST_002 404 Customer not found Check customer ID
RATE_003 429 Rate limit exceeded Reduce request frequency
SYS_004 500 Internal server error Wait and retry
CONF_005 400 Invalid configuration Check config file format

Debugging Tools

1. Logging Configuration

// Enable debug logging

{

"Logging": {

"LogLevel": {

"KillSwitch.Client": "Debug"

}

}

}

2. Test Endpoints

# Health check

GET /v1/status

Returns service status

# Validate API key

GET /v1/validate

Validates API key without customer check

Support Resources

Documentation

Complete API reference and guides

Get Started →

Community Forum

Get help from other developers

Get Started →

Emergency Support

For critical production issues, contact our 24/7 support team:

[email protected]