bytes additionne le volume téléversé de chaque client afin que vous puissiez le facturer. Le blueprint est fourni dans le package npm @dodopayments/ingestion-blueprints sous la forme de trackObjectStorage(), et fonctionne avec S3, Google Cloud Storage, Azure Blob Storage et d’autres services de stockage d’objets.
Cas d’utilisation
Le blueprint Object Storage convient aux scénarios suivants :File Hosting
Facturez aux clients le volume total des fichiers qu’ils téléversent.
Backup Services
Suivez les téléversements de données de sauvegarde et facturez le volume de données téléversé.
Media CDN
Surveillez les téléversements de contenus multimédias et facturez le volume téléversé. Pour facturer la bande passante de diffusion, utilisez le blueprint Stream.
Document Management
Suivez les téléversements de documents par client pour une tarification basée sur l’utilisation.
Utilisez-le pour facturer en fonction du volume téléversé pour les services d’hébergement de fichiers, de CDN multimédia et de sauvegarde. Le blueprint comptabilise les octets téléversés, et non les octets stockés au fil du temps.
Démarrage rapide
Pour suivre les téléversements, installez le package, créez un compteur et envoyez un événement après chaque téléversement réussi.1
Install the SDK
Installez le package Dodo Payments Ingestion Blueprints :
2
Get Your API Keys
Vous avez besoin de deux ensembles d’identifiants :
- Clé API Dodo Payments : créez-en une sous Developer → API Keys dans le tableau de bord Dodo Payments, puis stockez-la dans
DODO_PAYMENTS_API_KEY. Utilisez une clé de mode test pendant le développement. Une clé de mode test fonctionne uniquement avectest_mode. - Identifiants du fournisseur de stockage : les identifiants utilisés par votre SDK de stockage pour AWS S3, Google Cloud Storage, Azure Blob Storage ou un autre fournisseur.
3
Create a Meter
Dans le tableau de bord Dodo Payments, accédez à Products → Meters et cliquez sur Create Meter. Définissez les champs suivants :
- Meter Name : un nom descriptif, tel que
Storage Uploads. - Event Name :
object_storage_upload, ou un nom de votre choix. Il doit correspondre exactement àeventNamedans votre code (sensible à la casse). - Aggregation Type : Sum, pour additionner les octets téléversés.
- Over Property :
bytes, pour facturer en fonction de la taille du téléversement. - Measurement Unit : l’unité affichée sur les factures, par exemple
bytes.
4
Track Storage Usage
Envoyez l’événement une fois l’appel au stockage terminé avec succès. Dans ces exemples, un téléversement échoué génère une exception avant l’exécution de
trackObjectStorage(), et n’est donc pas facturé.Configuration
Configuration de l’ingestion
Transmettez ces options ànew Ingestion() :
string
requis
Votre clé API Dodo Payments provenant du tableau de bord.
string
Mode d’environnement :
test_mode ou live_mode. La valeur par défaut est test_mode. Les SDK Dodo Payments utilisent par défaut live_mode à la place ; définissez donc explicitement live_mode en production.string
requis
Nom de l’événement correspondant à Event Name de votre compteur (sensible à la casse).
Options de suivi du stockage d’objets
Transmettez ces options àtrackObjectStorage() :
string
requis
Identifiant client Dodo Payments à facturer pour le téléversement, par exemple
cus_123.number
Nombre d’octets téléversés. Requis pour la facturation basée sur les octets. Si vous l’omettez, l’événement ne contient aucune valeur
bytes, mais il est tout de même comptabilisé par un compteur Count.object
Métadonnées facultatives concernant le téléversement, comme le nom du bucket ou le type de contenu. Chaque valeur doit être une chaîne, un nombre ou une valeur booléenne.