Skip to main content
Object Storage Blueprint skickar en användningshändelse till Dodo Payments varje gång en kund laddar upp en fil, tillsammans med antalet uppladdade byte. En mätare av typen Sum över bytes summerar varje kunds uppladdningsvolym, så att du kan debitera för den. Blueprint-paketet ingår i npm-paketet @dodopayments/ingestion-blueprints som trackObjectStorage() och fungerar med S3, Google Cloud Storage, Azure Blob Storage och andra tjänster för objektlagring.

Användningsområden

Object Storage Blueprint passar för följande scenarier:

File Hosting

Debitera kunder för den totala volymen av filer som de laddar upp.

Backup Services

Spåra uppladdningar av säkerhetskopierade data och debitera baserat på mängden uppladdad data.

Media CDN

Övervaka uppladdningar av media och debitera baserat på uppladdningsvolym. Om du vill debitera för bandbredd vid leverans använder du Stream Blueprint.

Document Management

Spåra dokumentuppladdningar per kund för användningsbaserad prissättning.
Använd den för att debitera baserat på uppladdningsvolym för filhosting, media-CDN och säkerhetskopieringstjänster. Blueprint räknar uppladdade byte, inte byte som lagras över tid.

Snabbstart

Om du vill spåra uppladdningar installerar du paketet, skapar en mätare och skickar en händelse efter varje lyckad uppladdning.
1

Install the SDK

Installera paketet Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Du behöver två uppsättningar autentiseringsuppgifter:
  • Dodo Payments API key: Skapa en under Developer → API Keys i Dodo Payments dashboard och spara den i DODO_PAYMENTS_API_KEY. Använd en test mode-nyckel medan du bygger. En test mode-nyckel fungerar endast med test_mode.
  • Storage provider credentials: De autentiseringsuppgifter som ditt storage SDK använder för AWS S3, Google Cloud Storage, Azure Blob Storage eller någon annan leverantör.
3

Create a Meter

Gå till Products → Meters i Dodo Payments dashboard och klicka på Create Meter. Ange följande fält:
  • Meter Name: Ett beskrivande namn, till exempel Storage Uploads.
  • Event Name: object_storage_upload eller ett namn som du väljer. Det måste exakt matcha eventName i koden (skiftlägeskänsligt).
  • Aggregation Type: Sum, för att summera de uppladdade byten.
  • Over Property: bytes, för att debitera baserat på uppladdningsstorlek.
  • Measurement Unit: Den enhet som visas på fakturor, till exempel bytes.
4

Track Storage Usage

Skicka händelsen efter att storage-anropet har lyckats. I dessa exempel kastar en misslyckad uppladdning ett fel innan trackObjectStorage() körs, så den debiteras inte.

Konfiguration

Ingestion-konfiguration

Skicka följande alternativ till new Ingestion():
string
obligatorisk
Din Dodo Payments API key från dashboarden.
string
Miljöläge: test_mode eller live_mode. Standardvärdet är test_mode. Dodo Payments SDKs använder däremot live_mode som standard, så ange live_mode uttryckligen i produktion.
string
obligatorisk
Händelsenamnet som matchar mätarens Event Name (skiftlägeskänsligt).

Alternativ för att spåra objektlagring

Skicka följande alternativ till trackObjectStorage():
string
obligatorisk
Dodo Payments customer ID som ska debiteras för uppladdningen, till exempel cus_123.
number
Antalet uppladdade byte. Krävs för bytebaserad debitering. Om du utelämnar det saknar händelsen värdet bytes, men räknas fortfarande i en mätare av typen Count.
object
Valfria metadata om uppladdningen, till exempel bucketnamn eller innehållstyp. Varje värde måste vara en sträng, ett tal eller ett booleskt värde.

Bästa praxis

Spåra före eller efter uppladdning: Du kan spåra händelsen före eller efter den faktiska uppladdningen, beroende på din strategi för felhantering.
API:t har ingen endpoint för att ta bort en inmatad händelse. En händelse som skickas före en uppladdning som sedan misslyckas finns kvar i kundens användning.
Hantera uppladdningsfel: Spåra endast lyckade uppladdningar, så att du inte debiterar för misslyckade åtgärder.
Senast ändrad 26 september 2026