API Reference — Events Ingestion
Structure de l’événement
Required Fields
Required Fields
string
requis
Un identifiant unique pour l’événement, utilisé pour détecter les événements en double lors d’une nouvelle tentative. Dérivez-le de l’action, par exemple à partir de l’ID client + de l’action + de l’horodatage, afin qu’un événement réessayé conserve le même ID. Un UUID aléatoire différent à chaque nouvelle tentative permettrait de comptabiliser le même événement deux fois.
string
requis
L’ID client Dodo Payments. Doit être un client existant valide.
string
requis
Le type d’événement correspondant au nom de l’événement de votre meter (sensible à la casse). Exemples :
api.call, image.generated.Optional Fields
Optional Fields
string
Horodatage ISO 8601 (UTC). Utilise par défaut l’heure actuelle du serveur s’il est omis. À inclure pour une facturation précise avec les événements différés ou groupés. Les horodatages de plus d’une heure ou de plus de 5 minutes dans le futur sont rejetés.
object
Propriétés supplémentaires pour l’agrégation et le filtrage. Jusqu’à 50 clés ; chaque clé peut comporter jusqu’à 100 caractères et chaque valeur jusqu’à 500 caractères.
- Valeurs numériques :
bytes,tokens,duration_ms - Filtres :
endpoint,method,quality
Envoi d’événements
Modèles d’ingestion
Modèles d’événements prêts à l’emploi pour des cas d’utilisation courants. Commencez avec un modèle éprouvé au lieu de construire à partir de zéro.LLM Blueprint
API Gateway Blueprint
Object Storage Blueprint
Stream Blueprint
Time Range Blueprint
View All Blueprints
Meilleures pratiques
Use Unique Event IDs
Use Unique Event IDs
Utilisez des ID déterministes pour éviter les doublons :
${customerId}_${action}_${timestamp}.Implement Retries
Implement Retries
Effectuez une nouvelle tentative en cas d’erreurs 5xx et
429 avec un backoff exponentiel. N’effectuez pas de nouvelle tentative pour les autres erreurs 4xx.Include Timestamps
Include Timestamps
Omettez les horodatages pour les événements en temps réel. Incluez-les pour les événements différés ou groupés afin d’améliorer la précision.
Monitor Delivery
Monitor Delivery
Suivez les taux de réussite et mettez en file d’attente les événements échoués pour une nouvelle tentative.
Dépannage
Events not appearing
Events not appearing
- Le nom de l’événement doit correspondre exactement au meter (sensible à la casse)
- L’ID client doit exister dans votre compte
- Vérifiez que les filtres du meter n’excluent pas les événements
- Vérifiez que les horodatages sont récents
Authentication errors (401)
Authentication errors (401)
Vérifiez que la clé API est correcte et utilisez le format :
Bearer YOUR_API_KEY.Validation errors (400)
Validation errors (400)
Assurez-vous que tous les champs obligatoires sont présents :
event_id, customer_id, event_name.Metadata not aggregating
Metadata not aggregating
- Les clés de métadonnées doivent correspondre exactement à la propriété « Over Property » du meter
- Utilisez des nombres, pas des chaînes :
tokens: 150et nontokens: "150"