Common Issues
While using polvo, you might encounter some common issues. This guide will help you identify and resolve these problems quickly.
Authentication Errors
Symptom: You receive AuthenticationError
when trying to make API calls.
Possible Causes:
- Incorrect API key or credentials
- Expired OAuth token
- Using test credentials in production environment (or vice versa)
Solutions:
- Double-check your API keys and credentials
- Ensure your OAuth tokens are up to date and refresh if necessary
- Verify you're using the correct environment (test/production)
Rate Limiting Issues
Symptom: You're receiving RateLimitError
frequently.
Possible Causes:
- Making too many requests in a short time
- Incorrect rate limit configuration
Solutions:
- Implement exponential backoff in your requests
- Use polvo's built-in rate limiting features
- Optimize your code to reduce the number of API calls
Integration-Specific Problems
Stripe
Issue: Charges are being declined unexpectedly
Solutions:
- Check the card details are correct
- Ensure you're using a valid test card in test mode
- Verify the charge amount is above the minimum allowed
HubSpot
Issue: Contact creation fails
Solutions:
- Ensure all required fields are provided
- Check for duplicate contacts (email address must be unique)
- Verify your HubSpot account has sufficient contact limit
General Performance Issues
Symptom: API calls are taking longer than expected
Possible Causes:
- Network latency
- Large data sets
- Inefficient code
Solutions:
- Use asynchronous methods for better performance
- Implement pagination for large data sets
- Optimize your code to reduce unnecessary API calls
If you're experiencing issues not covered here, please check our Debugging Tips or FAQ for more information. If the problem persists, don't hesitate to reach out to our community or support channels.