Passer au contenu principal

Cas d’Utilisation

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

File Hosting

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

Backup Services

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

Media CDN

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

Document Management

Suivez les téléchargements de documents par client pour une tarification à 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

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

  • Clé API Dodo Payments : obtenez-la depuis le Dodo Payments Dashboard
  • Clé API du fournisseur de stockage : d’AWS S3, Google Cloud Storage, Azure, etc.
3

Create a Meter

Créez un compteur dans votre Dodo Payments Dashboard :
  • Nom de l’événement : object_storage_upload (ou le nom de votre choix)
  • Type d’agrégation : sum pour suivre le total des octets téléchargés
  • Propriété Over : bytes pour facturer en fonction de la taille du stockage
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
});

Configuration

Configuration d’Ingestion

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

Options de Suivi de Stockage d’Objets

customerId
string
requis
L’ID client pour l’attribution de la facturation.
bytes
number
Nombre d’octets téléchargés. Obligatoire 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

Suivre avant ou après le téléchargement : vous pouvez suivre l’événement avant ou après le téléchargement réel selon votre stratégie de gestion des erreurs.
Gérer les échecs de téléchargement : suivez uniquement les téléchargements réussis pour éviter de facturer les opérations échouées.