Skip to main content
Los eventos son la base de la facturación basada en el uso. Envía eventos cuando ocurren acciones facturables, y los medidores los agregan en cargos.

API Reference — Events Ingestion

Documentación completa de la API con ejemplos y códigos de respuesta.

Estructura del Evento

string
requerido
Un identificador único para el evento, utilizado para detectar eventos duplicados al reintentar. Derívalo de la acción, por ejemplo, ID de cliente + acción + marca de tiempo, para que un evento reintentado conserve el mismo ID. Un UUID aleatorio nuevo en cada reintento permite que el mismo evento se contabilice dos veces.
string
requerido
El ID de cliente de Dodo Payments. Debe corresponder a un cliente existente válido.
string
requerido
El tipo de evento que coincide con el nombre del evento de tu medidor (distingue entre mayúsculas y minúsculas). Ejemplos: api.call, image.generated.
string
Marca de tiempo ISO 8601 (UTC). Si se omite, se utiliza de forma predeterminada la hora actual del servidor. Inclúyela para una facturación precisa con eventos retrasados o por lotes. Se rechazan las marcas de tiempo con más de 1 hora de antigüedad o más de 5 minutos en el futuro.
object
Propiedades adicionales para la agregación y el filtrado. Hasta 50 claves; cada clave puede tener hasta 100 caracteres y cada valor, hasta 500 caracteres.
  • Valores numéricos: bytes, tokens, duration_ms
  • Filtros: endpoint, method, quality

Envío de Eventos

Agrupa hasta 1.000 eventos por solicitud para mejorar el rendimiento. La API aplica un límite estricto de 1.000 eventos por solicitud.

Plantillas de Ingesta

Patrones de eventos listos para casos de uso comunes. Comienza con una plantilla probada en lugar de construir desde cero.

LLM Blueprint

Realice un seguimiento del uso de tokens de IA en OpenAI, Anthropic, Groq, Gemini y más.

API Gateway Blueprint

Mida las solicitudes a la API con filtrado por punto final y compatibilidad con limitación de velocidad.

Object Storage Blueprint

Controle las cargas de archivos y el consumo de almacenamiento para servicios en la nube.

Stream Blueprint

Mida el ancho de banda de streaming para video, audio y datos en tiempo real.

Time Range Blueprint

Facture por tiempo transcurrido para funciones serverless e instancias de cómputo.

View All Blueprints

Vea todos los planos disponibles con guías detalladas de implementación.

Mejores Prácticas

Usa ID deterministas para evitar duplicados: ${customerId}_${action}_${timestamp}.
Reintenta ante errores 5xx y errores 429 con retroceso exponencial. No reintentes otros errores 4xx.
Omite las marcas de tiempo para eventos en tiempo real. Inclúyelas para eventos retrasados o por lotes para mayor precisión.
Monitoree las tasas de éxito y encole eventos fallidos para reintentos.

Solución de Problemas

  • El nombre del evento debe coincidir exactamente con el del medidor (distingue entre mayúsculas y minúsculas)
  • El ID de cliente debe existir en tu cuenta
  • Comprueba que los filtros del medidor no estén excluyendo eventos
  • Verifica que las marcas de tiempo sean recientes
Verifica que la clave de API sea correcta y utiliza el formato: Bearer YOUR_API_KEY.
Asegúrate de que estén presentes todos los campos obligatorios: event_id, customer_id, event_name.
  • Las claves de Metadata deben coincidir exactamente con “Over Property” del medidor
  • Usa números, no cadenas: tokens: 150, no tokens: "150"

Próximos Pasos

Create Meters

Defina cómo se agregan sus eventos en cantidades facturables con filtros y funciones de agregación.

Ingestion Blueprints

Utilice planos preconfeccionados para casos comunes como seguimiento de LLM, puertas de enlace de API y almacenamiento.

Complete Tutorial

Construya un generador completo de imágenes de IA con facturación basada en el uso desde cero.

API Reference

Documentación completa de la API con todos los parámetros, códigos de respuesta y pruebas interactivas.
Última modificación el 28 de septiembre de 2026