API Usage
Respect Rate Limits
Implement exponential backoff when you hit rate limits. Cache responses when possible to reduce API calls.
Handle Pagination
Use cursor-based pagination for large result sets. Don’t request more data than you need.
Secure Token Storage
Store access tokens and refresh tokens securely. Never log tokens or expose them in client-side code.
Webhook Handling
1
Respond quickly
Return a 2xx response within 5 seconds. Queue processing for later if needed.
2
Implement idempotency
Store webhook IDs to handle duplicate deliveries gracefully.
3
Verify signatures
Always validate webhook signatures before processing payloads.
4
Handle failures
Log failed processing and implement retry mechanisms.
Error Handling
User Experience
- Clear onboarding — Guide users through setup with clear instructions and progress indicators.
- Helpful error messages — Show actionable error messages that help users resolve issues.
- Sync status — Show sync status and last successful sync time.
- Easy disconnection — Provide a clear way for users to disconnect your app.
Next Steps
App Guidelines
Review listing requirements.
Submit for Review
Get your app approved.