Production Checklist

Idempotency, retries, errors, rate limits, webhooks, and environment configuration for production Trophy integrations.

Before deploying your Trophy integration to production, review the following recommended steps:

1. Implement idempotency

   Protect metric writes so retries and duplicate submissions do not double-count progress or awards.

   Idempotency

   More information on idempotency and how to use it in your integration.

2. Handle retries

   Handle transient failures when calling Trophy, and understand how Trophy retries webhook delivery to your endpoints.

   Client retry guidance

   When it’s safe to retry API calls, and when it’s not.

   Webhook retries

   How Trophy retries failed deliveries to your webhook endpoints.

3. Handle errors

   Understand the different types of errors Trophy emits, and how to handle them in your integration.

   Errors

   Common HTTP status codes emitted by the Trophy API.

4. Understand rate limits

   Trophy uses rate limits scoped at the organisation level to prevent abuse and ensure fair usage. Understand how to stay within them, and how to handle being throttled.

   Rate limiting

   Trophy’s tiered rate limit model and how it works.

5. Secure webhooks

   If you consume Trophy events in production via webhooks, ensure to set up signature verification to prevent spoofing.

   Webhooks overview

   What Trophy webhooks cover and when to use them.

   Security

   Verify webhook signatures in production.

6. Use environments

   Isolate development, staging, and production configuration and traffic so non-production work cannot affect live users.

   Environments

   Production, staging, and development environments in Trophy.

Get Support

Want to get in touch with the Trophy team? Reach out to us via email. We’re here to help!