Troubleshoot common issues you might encounter when using LicenseChain.
## API Errors
### 401 Unauthorized
Problem: Invalid or missing API key
Solution:
- Verify API key is correct
- Check Authorization header format
- Ensure key hasn't been revoked
- Regenerate key if needed
### 429 Too Many Requests
Problem: Rate limit exceeded
Solution:
- Check rate limit headers in response
- Implement request throttling
- Upgrade plan for higher limits
- Cache validation results
### 500 Internal Server Error
Problem: LicenseChain server issue
Solution:
- Retry request after a delay
- Check LicenseChain status page
- Contact support if persistent
## License Validation Errors
### LICENSE_NOT_FOUND
License key doesn't exist. Verify the key is correct.
### LICENSE_EXPIRED
License has passed expiration date. Renew or extend license.
### LICENSE_REVOKED
License was manually revoked. Contact support if this is unexpected.
### USER_LIMIT_EXCEEDED
Maximum number of users reached. Upgrade license or remove users.
### DEVICE_LIMIT_EXCEEDED
Maximum number of devices reached. Deactivate old devices.
## Integration Issues
### SDK Not Found
Install the SDK using npm or yarn package manager.
### Webhook Not Receiving Events
- Verify webhook URL is accessible
- Check HTTPS is enabled
- Verify webhook signature
- Review webhook logs in dashboard
### CORS Errors
Configure CORS on your server to allow LicenseChain domains.
## Getting Help
If you're still experiencing issues:
1. Check our documentation
2. Search existing help articles
3. Review API response error messages
4. Contact support@licensechain.app
5. Include error codes and request IDs