Error Handling & Best Practices
Error Handling
The API uses standard HTTP status codes and returns JSON-formatted error messages.
401 Unauthorized
Invalid or missing API key
{"error": "Invalid API credentials"}
422 Validation Error
Invalid request data
{"error": "Validation failed", "messages": {}}
429 Rate Limit
Too many requests
{"error": "Rate limit exceeded"}
404 Not Found
Resource does not exist
{"error": "No availability found"}
Best Practices
Security
- Never expose your API secret in client-side code or version control
- Store credentials in environment variables
- Rotate secrets every 3 months (you will receive warnings)
- Use HTTPS for all requests
Performance
- Choose the regional endpoint closest to your server
- Cache venue and table data (changes infrequently)
- Implement exponential backoff for rate limit errors
- Monitor your daily request count to avoid hitting limits
Integration
- Check availability before creating reservations
- Store the reservation reference for customer service
- Handle all error responses gracefully
- Set appropriate timeouts (recommended: 10 seconds)
Need Help?
Our support team is here to help you integrate successfully.
- Contact support:
[email protected] - WhatsApp support: https://wa.me/message/GPBDMIVKYIELE1