Saltar al contenido principal

Casos de Uso

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

Alojamiento de Archivos

Facturar a los clientes según el uso total de almacenamiento y el volumen de carga.

Servicios de Respaldo

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

CDN de Medios

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

Gestión de Documentos

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

Instalar el SDK

npm install @dodopayments/ingestion-blueprints
2

Obtén tus Claves API

  • Clave API de Dodo Payments: Consíguela en el Tablero de Dodo Payments
  • Clave API del Proveedor de Almacenamiento: De AWS S3, Google Cloud Storage, Azure, etc.
3

Crea un Medidor

Crea un medidor en tu Tablero de Dodo Payments:
  • Nombre del Evento: object_storage_upload (o tu nombre preferido)
  • Tipo de Agregación: sum para rastrear el total de bytes cargados
  • Sobre Propiedad: bytes para facturar según el tamaño de almacenamiento
4

Rastrear Uso de Almacenamiento

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
required
Tu clave API de Dodo Payments del tablero.
environment
string
required
Modo de entorno: test_mode o live_mode.
eventName
string
required
Nombre del evento que coincide con la configuración de tu medidor.

Opciones de Seguimiento de Almacenamiento de Objetos

customerId
string
required
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

Rastrear Antes o Después de la Carga: Puedes rastrear el evento antes o después de la carga real dependiendo de tu estrategia de manejo de errores.
Manejar Fallos de Carga: Solo rastrear cargas exitosas para evitar facturar por operaciones fallidas.