Reference
Troubleshooting
Common issues and solutions
Common issues and their solutions.
Authentication Issues
Invalid API Key
Error: 401 Unauthorized
Solution:
- Verify your API key in Settings → API Keys
- Ensure the API key is correctly set in your request headers
- Check that the API key hasn't been revoked
Missing API Key
Error: 401 Unauthorized with message "API key required"
Solution:
- Include the
X-API-Keyheader in all requests - For SDK users, ensure
client.setConfig()is called with your API key
Rate Limit Issues
Rate Limit Exceeded
Error: 429 Too Many Requests
Solution:
- Implement exponential backoff
- Use bulk endpoints when possible
- Monitor rate limit headers
- Consider upgrading to Enterprise tier for higher limits
Media Upload Issues
Upload Failed
Error: Upload fails during file upload
Solution:
- Verify file size is within platform limits
- Check file format is supported
- Ensure presigned URL hasn't expired (1 hour TTL)
- Verify network connection is stable
Aspect Ratio Errors
Error: Media doesn't meet platform aspect ratio requirements
Solution:
- Use the image cropping tool in the dashboard
- Check platform-specific aspect ratio requirements
- Use media validation before uploading
Post Publishing Issues
Post Failed to Publish
Error: Post fails to publish to platform
Common Causes:
- Channel disconnected or token expired
- Platform-specific content violations
- Rate limits on platform side
- Network issues
Solution:
- Check channel connection status
- Review platform-specific requirements
- Retry the publish operation
- Check platform status page for outages
SDK Issues
Type Errors
Error: TypeScript compilation errors
Solution:
- Ensure you're using TypeScript 5.0+
- Update to latest SDK version:
npm install fanbeam@latest - Check that types are imported correctly
Import Errors
Error: Module not found
Solution:
- Verify SDK is installed:
npm list fanbeam - Check Node.js version (18+ required)
- Clear node_modules and reinstall
Getting Help
If you're still experiencing issues:
- Check the API Documentation
- Review SDK Documentation
- Contact support at support@fanbeam.app