bytes suma el volumen cargado de cada cliente para que puedas facturarlo. El blueprint se incluye en el paquete npm @dodopayments/ingestion-blueprints como trackObjectStorage() y funciona con S3, Google Cloud Storage, Azure Blob Storage y otros servicios de almacenamiento de objetos.
Casos de uso
El Object Storage Blueprint es adecuado para estos escenarios:File Hosting
Cobra a los clientes por el volumen total de archivos que cargan.
Backup Services
Realiza un seguimiento de las cargas de datos de respaldo y cobra por la cantidad de datos cargados.
Media CDN
Supervisa las cargas de contenido multimedia y factura según el volumen cargado. Para facturar el ancho de banda de entrega, usa el Stream Blueprint.
Document Management
Realiza un seguimiento de las cargas de documentos por cliente para aplicar precios basados en el uso.
Úsalo para facturar según el volumen cargado en servicios de alojamiento de archivos, CDN de contenido multimedia y copias de seguridad. El blueprint cuenta los bytes cargados, no los bytes almacenados a lo largo del tiempo.
Inicio rápido
Para realizar un seguimiento de las cargas, instala el paquete, crea un medidor y envía un evento después de cada carga correcta.1
Install the SDK
Instala el paquete Dodo Payments Ingestion Blueprints:
2
Get Your API Keys
Necesitas dos conjuntos de credenciales:
- Clave de API de Dodo Payments: crea una en Developer → API Keys, dentro del panel de Dodo Payments, y guárdala en
DODO_PAYMENTS_API_KEY. Usa una clave de modo de prueba mientras desarrollas. Una clave de modo de prueba solo funciona contest_mode. - Credenciales del proveedor de almacenamiento: las credenciales que utiliza tu SDK de almacenamiento para AWS S3, Google Cloud Storage, Azure Blob Storage u otro proveedor.
3
Create a Meter
En el panel de Dodo Payments, ve a Products → Meters y haz clic en Create Meter. Configura estos campos:
- Meter Name: un nombre descriptivo, como
Storage Uploads. - Event Name:
object_storage_upload, o el nombre que elijas. Debe coincidir exactamente coneventNameen tu código (distingue entre mayúsculas y minúsculas). - Aggregation Type: Sum, para sumar los bytes cargados.
- Over Property:
bytes, para facturar según el tamaño de la carga. - Measurement Unit: la unidad que se muestra en las facturas, como
bytes.
4
Track Storage Usage
Envía el evento después de que la llamada de almacenamiento se complete correctamente. En estos ejemplos, una carga fallida genera un error antes de que se ejecute
trackObjectStorage(), por lo que no se factura.Configuración
Configuración de ingestión
Pasa estas opciones anew Ingestion():
string
requerido
Tu clave de API de Dodo Payments del panel.
string
Modo de entorno:
test_mode o live_mode. El valor predeterminado es test_mode. En cambio, los SDK de Dodo Payments usan live_mode de forma predeterminada, así que configura live_mode explícitamente en producción.string
requerido
Nombre del evento que coincide con el Event Name de tu medidor (distingue entre mayúsculas y minúsculas).
Opciones de seguimiento del almacenamiento de objetos
Pasa estas opciones atrackObjectStorage():
string
requerido
El ID de cliente de Dodo Payments al que se facturará la carga, por ejemplo
cus_123.number
Número de bytes cargados. Es obligatorio para la facturación basada en bytes. Si lo omites, el evento no tendrá un valor
bytes, pero seguirá contando para un medidor de tipo Count.object
Metadatos opcionales sobre la carga, como el nombre del bucket o el tipo de contenido. Cada valor debe ser una cadena, un número o un booleano.