Set your credentials using environment variables:

TREBLLE_SDK_TOKEN=your_sdk_token
TREBLLE_API_KEY=your_api_key

Where to find these values:

• Go to your Treblle 3.0 workspace
• Navigate to API Settings
• Copy your SDK Token and API Key

First, verify you’re using the correct platform:

• Use platform.treblle.com
• Don’t use the legacy app.treblle.com

Common troubleshooting steps:

1. Check your credentials - Ensure TREBLLE_SDK_TOKEN and TREBLLE_API_KEY match your workspace
2. Network settings - Allow HTTPS requests to *.treblle.com domains
3. Request limits - Verify you haven’t exceeded your plan’s monthly limit
4. SDK integration - Confirm the Treblle SDK is properly installed and configured

Still not working? Contact support at treblle.com → Resources → Support

Yes! Treblle works with localhost if:

• SDK is properly initialized
• Your machine has internet access
• No proxy blocks traffic to Treblle endpoints

Treblle prioritizes security with multiple layers of protection:

Automatic Data Masking

• Passwords, API keys, and sensitive fields are automatically masked
• Data is masked before leaving your server
• You control which additional fields to mask

Encryption & Compliance

• All data encrypted in transit and at rest
• ISO 27001, GDPR, SOC 2, CCPA, and PCI DSS compliant
• Regular security audits and assessments

What you can control:

• Exclude specific endpoints from logging
• Configure custom field masking
• Set up compliance scanning

If your URLs contain sensitive data, you have two options:

Option 1: Exclude the endpoint

// Example: Skip Treblle for sensitive endpoints
if (req.path.includes('/sensitive-endpoint')) {
return next(); // Skip Treblle middleware
}

Option 2: Redesign the URL structure

# Instead of:
/api/users/secret-key-123/profile
 
# Use:
/api/users/profile?token=secret-key-123
# (token will be masked in query parameters)

No DNS changes required!

Treblle integrates directly into your API backend via our SDK. You keep using your custom domain exactly as before.

How it works:

• Your API runs on your domain (e.g., api.yourcompany.com)
• Treblle SDK captures request/response data
• Data is sent to Treblle’s servers for analysis
• Your API continues working normally

Treblle creates docs automatically from your API traffic:

Real-time Analysis

• Analyzes incoming requests and responses
• Identifies patterns and data structures
• Generates OpenAPI specifications

Continuous Updates

• Documentation updates as your API evolves
• New endpoints automatically discovered
• Response schemas updated based on actual data

Testing Integration

• Use Aspen to test endpoints
• Documentation appears immediately after API calls
• Interactive documentation with examples

Common issue with Treblle 3.0 upgrades:

Use environment variables (recommended):

# In your .env file
TREBLLE_API_KEY=your_api_key
TREBLLE_SDK_TOKEN=your-sdk-token

Remove hardcoded credentials:

// Remove this old configuration
treblle({
apiKey: "hardcoded_key",
sdk_token: "hardcoded_token"
})
 
// SDK will automatically use environment variables
treblle()

Debugging steps:

1. Check your .env file has correct values
2. Restart your application after changes
3. Verify you’re using the latest SDK version
4. Check for typos in environment variable names

SSL timeout errors usually indicate network issues:

Network Troubleshooting:

• Check if your deployment environment can reach external services
• Verify no firewall rules block outbound HTTPS requests
• Test connection to treblle.com from your server

Code Solutions:

// Add retry logic for network issues
const treblle = require('treblle');
 
// Configure with timeout settings
treblle({
timeout: 10000, // 10 second timeout
retries: 3      // Retry failed requests
});

Monitoring:

• Add detailed logging around SDK initialization
• Monitor SSL handshake timing
• Check server resource usage during requests

Access your invoices through Workspace Settings:

Step-by-step:

1. Go to Workspace Settings → Billing
2. Find the Invoice History section
3. Click on any invoice to download PDF

Free plan includes 250,000 requests per month.

When you exceed the limit:

• Treblle stops processing new requests
• Your API continues working normally
• Limit resets at the start of next month

Solutions:

• Monitor usage: Check your dashboard regularly
• Upgrade plan: Consider higher tiers for more requests
• Optimize: Focus logging on critical endpoints only