Skip to main content
L’Object Storage Blueprint invia un evento di utilizzo a Dodo Payments ogni volta che un cliente carica un file, indicando il numero di byte caricati. Un meter Sum su bytes somma il volume di caricamento di ogni cliente, permettendoti di fatturarlo. Il blueprint è incluso nel pacchetto npm @dodopayments/ingestion-blueprints come trackObjectStorage() e funziona con S3, Google Cloud Storage, Azure Blob Storage e altri servizi di object storage.

Casi d’uso

L’Object Storage Blueprint è adatto ai seguenti scenari:

File Hosting

Fattura ai clienti il volume totale dei file che caricano.

Backup Services

Monitora i caricamenti dei dati di backup e addebita la quantità di dati caricati.

Media CDN

Monitora i caricamenti di contenuti multimediali e fattura il volume di caricamento. Per fatturare la larghezza di banda di distribuzione, usa lo Stream Blueprint.

Document Management

Monitora i caricamenti di documenti per cliente per applicare prezzi basati sull’utilizzo.
Usalo per fatturare in base al volume di caricamento per servizi di file hosting, media CDN e backup. Il blueprint conta i byte caricati, non i byte archiviati nel tempo.

Avvio rapido

Per monitorare i caricamenti, installa il pacchetto, crea un meter e invia un evento dopo ogni caricamento completato correttamente.
1

Install the SDK

Installa il pacchetto Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Sono necessari due set di credenziali:
  • Chiave API di Dodo Payments: creane una in Developer → API Keys nella dashboard di Dodo Payments e salvala in DODO_PAYMENTS_API_KEY. Usa una chiave in modalità test durante lo sviluppo. Una chiave in modalità test funziona solo con test_mode.
  • Credenziali del provider di storage: le credenziali utilizzate dal tuo SDK di storage per AWS S3, Google Cloud Storage, Azure Blob Storage o un altro provider.
3

Create a Meter

Nella dashboard di Dodo Payments, vai su Products → Meters e fai clic su Create Meter. Imposta questi campi:
  • Meter Name: un nome descrittivo, ad esempio Storage Uploads.
  • Event Name: object_storage_upload oppure un nome a tua scelta. Deve corrispondere esattamente a eventName nel codice (distinzione tra maiuscole e minuscole).
  • Aggregation Type: Sum, per sommare i byte caricati.
  • Over Property: bytes, per fatturare in base alla dimensione del caricamento.
  • Measurement Unit: l’unità mostrata sulle fatture, ad esempio bytes.
4

Track Storage Usage

Invia l’evento dopo che la chiamata allo storage è completata correttamente. In questi esempi, un caricamento non riuscito genera un’eccezione prima dell’esecuzione di trackObjectStorage(), quindi non viene fatturato.

Configurazione

Configurazione dell’ingestion

Passa queste opzioni a new Ingestion():
string
obbligatorio
La tua chiave API di Dodo Payments dalla dashboard.
string
Modalità dell’ambiente: test_mode o live_mode. Il valore predefinito è test_mode. Gli SDK di Dodo Payments utilizzano invece live_mode per impostazione predefinita, quindi imposta esplicitamente live_mode in produzione.
string
obbligatorio
Il nome dell’evento che corrisponde a Event Name del meter (distinzione tra maiuscole e minuscole).

Opzioni per il monitoraggio di Object Storage

Passa queste opzioni a trackObjectStorage():
string
obbligatorio
L’ID cliente Dodo Payments da fatturare per il caricamento, ad esempio cus_123.
number
Numero di byte caricati. Obbligatorio per la fatturazione basata sui byte. Se lo ometti, l’evento non contiene un valore bytes, ma viene comunque conteggiato in un meter Count.
object
Metadati facoltativi sul caricamento, come il nome del bucket o il tipo di contenuto. Ogni valore deve essere una stringa, un numero o un booleano.

Best practice

Monitora prima o dopo il caricamento: puoi monitorare l’evento prima o dopo il caricamento effettivo, in base alla strategia di gestione degli errori.
L’API non dispone di un endpoint per eliminare un evento acquisito. Un evento inviato prima di un caricamento che successivamente non va a buon fine rimane nell’utilizzo del cliente.
Gestisci i caricamenti non riusciti: monitora solo i caricamenti completati correttamente, così non fatturi le operazioni non riuscite.
Ultima modifica il 26 settembre 2026