API Reference — Events Ingestion
Documentazione completa dell’API con esempi e codici di risposta.
Struttura dell’Evento
Required Fields
Required Fields
string
obbligatorio
Un identificatore univoco per l’evento, utilizzato per rilevare eventi duplicati durante un nuovo tentativo. Derivalo dall’azione, ad esempio ID cliente + azione + timestamp, in modo che un evento ritentato mantenga lo stesso ID. Un UUID casuale nuovo a ogni tentativo consente di conteggiare due volte lo stesso evento.
string
obbligatorio
L’ID cliente di Dodo Payments. Deve corrispondere a un cliente esistente valido.
string
obbligatorio
Il tipo di evento che corrisponde al nome dell’evento del tuo meter (con distinzione tra maiuscole e minuscole). Esempi:
api.call, image.generated.Optional Fields
Optional Fields
string
Timestamp in formato ISO 8601 (UTC). Se omesso, viene impostato sull’ora corrente del server. Includilo per una fatturazione accurata con eventi ritardati o elaborati in batch. I timestamp più vecchi di 1 ora o più avanti di 5 minuti nel futuro vengono rifiutati.
object
Proprietà aggiuntive per l’aggregazione e il filtraggio. Fino a 50 chiavi; ogni chiave può contenere fino a 100 caratteri e ogni valore fino a 500 caratteri.
- Valori numerici:
bytes,tokens,duration_ms - Filtri:
endpoint,method,quality
Invio di Eventi
Modelli di Ingestione
Modelli di eventi pronti all’uso per casi d’uso comuni. Inizia con un modello collaudato invece di costruire da zero.LLM Blueprint
Monitora l’utilizzo dei token AI su OpenAI, Anthropic, Groq, Gemini e altro.
API Gateway Blueprint
Misura le richieste API con filtraggio degli endpoint e supporto per il rate limiting.
Object Storage Blueprint
Monitora i caricamenti di file e il consumo di storage per i servizi di cloud storage.
Stream Blueprint
Misura la larghezza di banda streaming per video, audio e dati in tempo reale.
Time Range Blueprint
Fattura in base al tempo trascorso per funzioni serverless e istanze di calcolo.
View All Blueprints
Vedi tutti i blueprint disponibili con guide di implementazione dettagliate.
Migliori Pratiche
Use Unique Event IDs
Use Unique Event IDs
Usa ID deterministici per prevenire i duplicati:
${customerId}_${action}_${timestamp}.Implement Retries
Implement Retries
Esegui un nuovo tentativo in caso di errori 5xx e
429, utilizzando un backoff esponenziale. Non ripetere il tentativo per altri errori 4xx.Include Timestamps
Include Timestamps
Ometti i timestamp per gli eventi in tempo reale. Includili per gli eventi ritardati o elaborati in batch, per garantire la precisione.
Monitor Delivery
Monitor Delivery
Monitora i tassi di successo e accoda gli eventi falliti per il retry.
Risoluzione dei Problemi
Events not appearing
Events not appearing
- Il nome dell’evento deve corrispondere esattamente al meter (con distinzione tra maiuscole e minuscole)
- L’ID cliente deve esistere nel tuo account
- Verifica che i filtri del meter non escludano gli eventi
- Verifica che i timestamp siano recenti
Authentication errors (401)
Authentication errors (401)
Verifica che la API key sia corretta e utilizza il formato:
Bearer YOUR_API_KEY.Validation errors (400)
Validation errors (400)
Assicurati che siano presenti tutti i campi obbligatori:
event_id, customer_id, event_name.Metadata not aggregating
Metadata not aggregating
- Le chiavi dei metadati devono corrispondere esattamente a “Over Property” del meter
- Usa numeri, non stringhe:
tokens: 150nontokens: "150"
Prossimi Passi
Create Meters
Definisci come i tuoi eventi vengono aggregati in quantità fatturabili con filtri e funzioni di aggregazione.
Ingestion Blueprints
Usa blueprint pronti per casi d’uso comuni come monitoraggio LLM, gateway API e storage.
Complete Tutorial
Costruisci da zero un generatore di immagini AI con fatturazione basata sull’utilizzo.
API Reference
Documentazione API completa con tutti i parametri, codici di risposta e test interattivi.