Troubleshooting

Template-Specific Issues

Template Not Found

"Template not found" Error

Symptoms: API calls return 404 with “Template not found” messageSolutions:

Verify Template ID: Check the exact template ID using the templates list endpoint
Check Category: Ensure you’re looking in the right template category
Template Status: Verify the template is published and active
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

"Validation failed" Error

Symptoms: PDF generation fails with data validation errorsSolutions:

Check Required Fields: Ensure all required fields are provided
Data Types: Verify data types match template requirements (string, number, date)
Date Formats: Use YYYY-MM-DD format for dates
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

"Invalid API Key" Error

Symptoms: API calls return 401 Unauthorized with “Invalid API Key” messageSolutions:

Check Key: Ensure you copied the entire API key without extra spaces
Header Format: Use exact format: x-api-key: YOUR_API_KEY
Key Status: Verify key hasn’t been revoked in your dashboard
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"

"Unauthorized" Error

Symptoms: General 401 errors or “Unauthorized” messagesSolutions:

Login Status: Ensure you’re logged into your account
Session Expired: Log out and log back in to refresh session
Account Status: Check if your account is active and in good standing
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

"HTML content is required" Error

Symptoms: API returns error about missing HTML contentSolutions:

Request Body: Ensure HTML is provided in the request body
Content-Type: Check header is set to application/json
JSON Escape: Verify HTML is properly escaped in JSON
Empty Content: Make sure HTML field isn’t empty or null

Correct Format:

{
  "html": "<html><body><h1>Content</h1></body></html>",
  "fileName": "document.pdf"
}

Poor PDF Quality Issues

Symptoms: Blurry text, missing images, layout problemsSolutions:

Image Resolution: Use high-resolution images (300+ DPI)
Font Issues: Use web-safe fonts or embed fonts properly
CSS Problems: Follow PDF-friendly CSS practices
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

"Insufficient Balance" Error

Symptoms: PDF generation blocked due to plan limitsSolutions:

Check Usage: View current usage in your dashboard
Plan Upgrade: Consider upgrading to a higher tier
Billing Issue: Verify payment method is current
Usage Reset: Wait for next billing cycle if near reset

Quick Check: Log into dashboard → Usage section → Check remaining balance

Payment Failed Issues

Symptoms: Unable to upgrade plan or payment declinedSolutions:

Card Details: Check expiration date and CVV code
Billing Address: Ensure address matches your card exactly
International Payments: Contact bank about international transactions
Payment Method: Try different card or PayPal
Currency Issues: Verify your bank supports USD transactions

Response Times

Plan	Support Type	Response Time
Free	Community	Best effort
Starter	Email	24-48 hours
Basic	Priority Email	12-24 hours
Premium	Email + Phone	2-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

Getting started

API Integration

MCP Integration

Configuration

Support

Troubleshooting

Troubleshooting

Template-Specific Issues

Template Not Found

Data Validation Errors

Common Issues

Authentication Problems

PDF Generation Issues

Subscription & Billing Issues

Response Times

How to Contact Support

Emergency Contact

Advanced Troubleshooting

Debugging API Calls

Network Issues

Performance Troubleshooting

Slow PDF Generation

Browser Console Errors

Preventive Measures

Best Practices to Avoid Issues

API Usage

Content Optimization

Security

Monitoring

​Troubleshooting

​Template-Specific Issues

​Template Not Found

​Data Validation Errors

​Common Issues

​Authentication Problems

​PDF Generation Issues

​Subscription & Billing Issues

​Response Times

​How to Contact Support

​Emergency Contact

​Advanced Troubleshooting

​Debugging API Calls

​Network Issues

​Performance Troubleshooting

Slow PDF Generation

​Browser Console Errors

​Preventive Measures

​Best Practices to Avoid Issues

API Usage

Content Optimization

Security

Monitoring

Troubleshooting

Template-Specific Issues

Template Not Found

Data Validation Errors

Common Issues

Authentication Problems

PDF Generation Issues

Subscription & Billing Issues

Response Times

How to Contact Support

Emergency Contact

Advanced Troubleshooting

Debugging API Calls

Network Issues

Performance Troubleshooting

Browser Console Errors

Preventive Measures

Best Practices to Avoid Issues