Passer au contenu principal

Cas d’Utilisation

Explorez les scénarios courants pris en charge par le Plan de Stockage d’Objets :

Hébergement de Fichiers

Facturez les clients en fonction de l’utilisation totale du stockage et du volume de téléchargement.

Services de Sauvegarde

Suivez les téléchargements de données de sauvegarde et facturez par Go stocké.

CDN Média

Surveillez les téléchargements de médias et facturez pour le stockage et la bande passante.

Gestion de Documents

Suivez les téléchargements de documents par client pour une tarification basée sur l’utilisation.
Parfait pour la facturation basée sur les téléchargements de stockage, l’hébergement de fichiers, l’utilisation de CDN ou les services de sauvegarde.

Démarrage Rapide

Suivez les téléchargements de stockage d’objets avec les octets consommés :
1

Installer le SDK

npm install @dodopayments/ingestion-blueprints
2

Obtenez vos Clés API

  • Clé API Dodo Payments : Obtenez-la depuis le Tableau de Bord Dodo Payments
  • Clé API du Fournisseur de Stockage : Depuis AWS S3, Google Cloud Storage, Azure, etc.
3

Créez un Compteur

Créez un compteur dans votre Tableau de Bord Dodo Payments :
  • Nom de l’Événement : object_storage_upload (ou votre nom préféré)
  • Type d’Agrégation : sum pour suivre le total des octets téléchargés
  • Sur Propriété : bytes pour facturer en fonction de la taille de stockage
4

Suivez l'Utilisation du Stockage

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
});

Configuration

Configuration d’Ingestion

apiKey
string
required
Votre clé API Dodo Payments depuis le tableau de bord.
environment
string
required
Mode d’environnement : test_mode ou live_mode.
eventName
string
required
Nom de l’événement qui correspond à votre configuration de compteur.

Options de Suivi de Stockage d’Objets

customerId
string
required
L’ID client pour l’attribution de facturation.
bytes
number
Nombre d’octets téléchargés. Requis pour la facturation basée sur les octets.
metadata
object
Métadonnées optionnelles sur le téléchargement comme le nom du bucket, le type de contenu, etc.

Meilleures Pratiques

Suivez Avant ou Après le Téléchargement : Vous pouvez suivre l’événement avant ou après le téléchargement réel en fonction de votre stratégie de gestion des erreurs.
Gérez les Échecs de Téléchargement : Ne suivez que les téléchargements réussis pour éviter de facturer des opérations échouées.