Troubleshooting

Common Issues

Authentication Problems

PDF Generation Issues

Subscription & Billing Issues

Response Times

PlanSupport TypeResponse Time
FreeCommunityBest effort
StarterEmail24-48 hours
BasicPriority Email12-24 hours
PremiumEmail + Phone2-4 hours

How to Contact Support

Email Support: support@peedief.com Include in Your Request:
  • Your account email address
  • API key (first 6 characters only)
  • Detailed description of the issue
  • Steps you’ve already tried
  • Error messages (exact text)
  • Sample code or HTML (if relevant)
Example Support Request:
Subject: PDF Generation Failing - HTML Content Error

Account: user@example.com
API Key: abc123...

Issue: Getting "HTML content is required" error even though HTML is included

Steps Tried:
1. Verified Content-Type header is application/json
2. Tested with simple HTML content
3. Checked for JSON escaping issues

Error Message: 
"HTML content is required"

Sample Request:
{curl command here}

Emergency Contact

For critical issues affecting production systems:
  • Email: emergency@peedief.com (Premium plans only)
  • Response: Within 2 hours during business hours
  • Issues: Service outages, data loss, security concerns

Advanced Troubleshooting

Debugging API Calls

Enable detailed logging to diagnose issues:
async function debugPDFGeneration(html, options) {
  console.log('Request payload:', { html: html.substring(0, 100) + '...', options });
  
  try {
    const response = await fetch('https://peedief.com/api/pdf', {
      method: 'POST',
      headers: {
        'x-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ html, options })
    });
    
    console.log('Response status:', response.status);
    console.log('Response headers:', Object.fromEntries(response.headers));
    
    const result = await response.text();
    console.log('Response body:', result);
    
    return JSON.parse(result);
  } catch (error) {
    console.error('Request failed:', error);
    throw error;
  }
}

Network Issues

Connection Problems:
  • Check firewall settings for outbound HTTPS
  • Verify DNS resolution for peedief.com
  • Test from different network/location
  • Use ping/traceroute for network diagnostics
Timeout Issues:
  • Increase request timeout (default: 30 seconds)
  • Reduce HTML content size
  • Optimize images and CSS
  • Try during off-peak hours

Performance Troubleshooting

Slow PDF Generation

Common Causes:
  • Large images or complex CSS
  • External resources (fonts, images)
  • Heavy HTML content (>1MB)
  • Peak usage times
Solutions:
  • Optimize image sizes
  • Embed resources as data URLs
  • Simplify CSS and layout
  • Generate during off-peak hours

Browser Console Errors

For web-based integrations, check browser console: Common Console Errors:
  • CORS errors: Use server-side API calls instead
  • Mixed content: Ensure HTTPS for all resources
  • Network errors: Check internet connection
  • Authentication: Verify API key configuration

Preventive Measures

Best Practices to Avoid Issues

API Usage

  • Implement retry logic with backoff
  • Validate HTML before sending
  • Use proper error handling
  • Monitor usage and limits

Content Optimization

  • Test HTML in browser first
  • Use web-safe fonts
  • Optimize images for web
  • Keep HTML under 2MB

Security

  • Store API keys securely
  • Rotate keys periodically
  • Monitor for unusual usage
  • Use HTTPS for all requests

Monitoring

  • Set up usage alerts
  • Monitor error rates
  • Track processing times
  • Review monthly analytics