Skip to main content

​
Troubleshooting

​
Template-Specific Issues

​
Template Not Found

Symptoms: API calls return 404 with “Template not found” messageSolutions:
  1. Verify Template ID: Check the exact template ID using the templates list endpoint
  2. Check Category: Ensure you’re looking in the right template category
  3. Template Status: Verify the template is published and active
  4. Case Sensitivity: Template IDs are case-sensitive
Test Command:
curl -H "x-api-key: YOUR_API_KEY" \
     "https://peedief.com/api/templates"

​
Data Validation Errors

Symptoms: PDF generation fails with data validation errorsSolutions:
  1. Check Required Fields: Ensure all required fields are provided
  2. Data Types: Verify data types match template requirements (string, number, date)
  3. Date Formats: Use YYYY-MM-DD format for dates
  4. Field Lengths: Check maximum length constraints
Test Command:
curl -X POST "https://peedief.com/api/templates/template-id/validate" \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"data": {"field": "value"}}'

​
Common Issues

​
Authentication Problems

Symptoms: API calls return 401 Unauthorized with “Invalid API Key” messageSolutions:
  1. Check Key: Ensure you copied the entire API key without extra spaces
  2. Header Format: Use exact format: x-api-key: YOUR_API_KEY
  3. Key Status: Verify key hasn’t been revoked in your dashboard
  4. Regenerate: Create a new API key if the current one isn’t working
Test Command:
curl -H "x-api-key: YOUR_API_KEY" \
     "https://peedief.com/api/user"
Symptoms: General 401 errors or “Unauthorized” messagesSolutions:
  1. Login Status: Ensure you’re logged into your account
  2. Session Expired: Log out and log back in to refresh session
  3. Account Status: Check if your account is active and in good standing
  4. Plan Limits: Verify you haven’t exceeded your plan’s PDF limit
Check Account Status: Visit your dashboard to confirm account status and usage.

​
PDF Generation Issues

Symptoms: API returns error about missing HTML contentSolutions:
  1. Request Body: Ensure HTML is provided in the request body
  2. Content-Type: Check header is set to application/json
  3. JSON Escape: Verify HTML is properly escaped in JSON
  4. Empty Content: Make sure HTML field isn’t empty or null
Correct Format:
{
  "html": "<html><body><h1>Content</h1></body></html>",
  "fileName": "document.pdf"
}
Symptoms: Blurry text, missing images, layout problemsSolutions:
  1. Image Resolution: Use high-resolution images (300+ DPI)
  2. Font Issues: Use web-safe fonts or embed fonts properly
  3. CSS Problems: Follow PDF-friendly CSS practices
  4. Scale Setting: Try different scale values between 0.8-1.2
Quality CSS:
body {
  font-family: Arial, sans-serif;
  font-size: 12pt;
  line-height: 1.4;
}

img {
  max-width: 100%;
  image-rendering: optimizeQuality;
}

​
Subscription & Billing Issues

Symptoms: PDF generation blocked due to plan limitsSolutions:
  1. Check Usage: View current usage in your dashboard
  2. Plan Upgrade: Consider upgrading to a higher tier
  3. Billing Issue: Verify payment method is current
  4. Usage Reset: Wait for next billing cycle if near reset
Quick Check: Log into dashboard → Usage section → Check remaining balance
Symptoms: Unable to upgrade plan or payment declinedSolutions:
  1. Card Details: Check expiration date and CVV code
  2. Billing Address: Ensure address matches your card exactly
  3. International Payments: Contact bank about international transactions
  4. Payment Method: Try different card or PayPal
  5. Currency Issues: Verify your bank supports USD transactions

​
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
⌘I