Skip to main content
Les événements sont la base de la facturation basée sur l’utilisation. Envoyez des événements lorsque des actions facturables se produisent, et les compteurs les agrègent en charges.

API Reference — Events Ingestion

Documentation complète de l’API avec des exemples et des codes de réponse.

Structure de l’événement

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.
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

Regroupez jusqu’à 1 000 événements par requête pour de meilleures performances. L’API impose une limite stricte de 1 000 événements par requête.

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

Suivez l’utilisation des jetons IA pour OpenAI, Anthropic, Groq, Gemini et plus encore.

API Gateway Blueprint

Mesurez les requêtes API avec filtrage par point de terminaison et prise en charge de la limitation de débit.

Object Storage Blueprint

Suivez les téléchargements de fichiers et la consommation de stockage pour les services de stockage cloud.

Stream Blueprint

Mesurez la bande passante de streaming pour la vidéo, l’audio et les données en temps réel.

Time Range Blueprint

Facturez en fonction du temps écoulé pour les fonctions serverless et les instances de calcul.

View All Blueprints

Consultez tous les plans disponibles avec des guides d’implémentation détaillés.

Meilleures pratiques

Utilisez des ID déterministes pour éviter les doublons : ${customerId}_${action}_${timestamp}.
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.
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.
Suivez les taux de réussite et mettez en file d’attente les événements échoués pour une nouvelle tentative.

Dépannage

  • 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
Vérifiez que la clé API est correcte et utilisez le format : Bearer YOUR_API_KEY.
Assurez-vous que tous les champs obligatoires sont présents : event_id, customer_id, event_name.
  • 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: 150 et non tokens: "150"

Prochaines étapes

Create Meters

Définissez comment vos événements sont agrégés en quantités facturables avec des filtres et des fonctions d’agrégation.

Ingestion Blueprints

Utilisez des plans prêts à l’emploi pour des cas d’usage courants comme le suivi de LLM, les passerelles API et le stockage.

Complete Tutorial

Construisez un générateur d’images IA complet avec facturation basée sur l’utilisation à partir de zéro.

API Reference

Documentation complète de l’API avec tous les paramètres, codes de réponse et tests interactifs.
Dernière modification le 26 septembre 2026