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
Identificador único. Use UUIDs o combine ID de cliente + marca temporal + acción.
string
requerido
ID de cliente de Dodo Payments. Debe ser un cliente válido existente.
string
requerido
Tipo de evento que coincide con el nombre del evento de su medidor (sensible a mayúsculas). Ejemplos: api.call, image.generated
string
Marca de tiempo ISO 8601 (UTC). Si se omite, se establece de forma predeterminada en la hora actual del servidor. Inclúyala 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 con más de 5 minutos de adelanto.
object
Propiedades adicionales para agregación y filtrado:
  • Valores numéricos: bytes, tokens, duration_ms
  • Filtros: endpoint, method, quality

Envío de Eventos

Agrupe hasta 1,000 eventos por solicitud para un mejor rendimiento. La API impone un límite máximo de 1,000 eventos por llamada.

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

Use IDs deterministas para evitar duplicados: ${customerId}_${action}_${timestamp}
Reintente ante errores 5xx con retroceso exponencial. No reintente errores 4xx.
Omita en eventos en tiempo real. Inclúyalo en 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 medidor (sensible a mayúsculas)
  • El ID del cliente debe existir
  • Verifique que los filtros del medidor no estén excluyendo eventos
  • Verifique que las marcas temporales sean recientes
Verifique que la clave de la API sea correcta y use el formato: Bearer YOUR_API_KEY
Asegúrese de que todos los campos obligatorios estén presentes: event_id, customer_id, event_name
  • Las claves de metadatos deben coincidir exactamente con la “Over Property” del medidor
  • Use 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 31 de julio de 2026