Saltar al contenido principal

Casos de Uso

Explora escenarios comunes soportados por el Plano de Almacenamiento de Objetos:

File Hosting

Factura a los clientes según el uso total de almacenamiento y el volumen de cargas.

Backup Services

Realiza un seguimiento de las cargas de datos de respaldo y cobra por GB almacenado.

Media CDN

Supervisa las cargas de medios y factura por almacenamiento y ancho de banda.

Document Management

Realiza un seguimiento de las cargas de documentos por cliente para precios basados en el uso.
Perfecto para facturación basada en cargas de almacenamiento, alojamiento de archivos, uso de CDN o servicios de respaldo.

Inicio Rápido

Realiza un seguimiento de las cargas de almacenamiento de objetos con bytes consumidos:
1

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

  • Dodo Payments API Key: Obténla desde Dodo Payments Dashboard
  • Storage Provider API Key: Desde AWS S3, Google Cloud Storage, Azure, etc.
3

Create a Meter

Crea un medidor en tu Dodo Payments Dashboard:
  • Event Name: object_storage_upload (o el nombre que prefieras)
  • Aggregation Type: sum para rastrear el total de bytes cargados
  • Over Property: bytes para facturar según el tamaño de almacenamiento
4

Track Storage Usage

import { Ingestion, trackObjectStorage } from '@dodopayments/ingestion-blueprints';
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
import fs from 'fs';

const ingestion = new Ingestion({
  apiKey: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
  eventName: 'object_storage_upload'
});

const s3 = new S3Client({ region: 'us-east-1' });

// Read the file (example: from disk or request)
const fileBuffer = fs.readFileSync('./document.pdf');

// Upload to S3
const command = new PutObjectCommand({
  Bucket: 'my-bucket',
  Key: 'uploads/document.pdf',
  Body: fileBuffer
});

await s3.send(command);

// Track the upload
await trackObjectStorage(ingestion, {
  customerId: 'customer_123',
  bytes: fileBuffer.length
});

Configuración

Configuración de Ingesta

apiKey
string
requerido
Tu clave de API de Dodo Payments desde el panel.
environment
string
requerido
Modo de entorno: test_mode o live_mode.
eventName
string
requerido
Nombre del evento que coincida con la configuración de tu medidor.

Opciones de Seguimiento de Almacenamiento de Objetos

customerId
string
requerido
El ID del cliente para la atribución de facturación.
bytes
number
Número de bytes cargados. Requerido para facturación basada en bytes.
metadata
object
Metadatos opcionales sobre la carga, como el nombre del bucket, tipo de contenido, etc.

Mejores Prácticas

Rastrea antes o después de la carga: Puedes registrar el evento antes o después de la carga real según tu estrategia de manejo de errores.
Gestiona fallos en la carga: Solo registra las cargas exitosas para evitar facturar operaciones fallidas.