Vai al contenuto principale

​
Casi d’uso

Esplora scenari comuni supportati dall’API Gateway Blueprint:

API-as-a-Service

Monitora l’utilizzo per cliente per piattaforme API e addebita in base al numero di chiamate.

Rate Limiting

Monitora i modelli di utilizzo delle API e implementa il rate limiting basato sull’utilizzo.

Performance Monitoring

Monitora i tempi di risposta e i tassi di errore insieme ai dati di fatturazione.

Multi-Tenant SaaS

Fattura i clienti in base al loro consumo API attraverso diversi endpoint.
Ideale per monitorare l’utilizzo degli endpoint API, il rate limiting e implementare la fatturazione API basata sull’utilizzo.

​
Avvio Veloce

Monitora le chiamate API a livello di gateway con batching automatico per scenari ad alto volume:
1

Installa l'SDK

npm install @dodopayments/ingestion-blueprints
2

Ottieni le tue chiavi API

3

Crea un Meter

Crea un meter nel tuo Dodo Payments Dashboard:
  • Nome Evento: api_call (o il tuo nome preferito)
  • Tipo di Aggregazione: count per monitorare il numero di chiamate
  • Configura proprietà aggiuntive se monitori metadati come tempi di risposta, codici di stato, ecc.
4

Monitora le Chiamate API

import { Ingestion, trackAPICall } from '@dodopayments/ingestion-blueprints';

const ingestion = new Ingestion({
  apiKey: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
  eventName: 'api_call'
});

// Track a single API call
await trackAPICall(ingestion, {
  customerId: 'customer_123',
  metadata: {
    endpoint: '/api/v1/users',
    method: 'GET',
    status_code: 200,
    response_time_ms: 45
  }
});

​
Configurazione

​
Configurazione dell’Ingestione

​
apiKey
string
obbligatorio
La tua chiave API Dodo Payments dal dashboard.
​
environment
string
obbligatorio
Modalità ambiente: test_mode o live_mode.
​
eventName
string
obbligatorio
Nome evento che corrisponde alla configurazione del tuo meter.

​
Opzioni di Monitoraggio delle Chiamate API

​
customerId
string
obbligatorio
L’ID cliente per l’attribuzione della fatturazione.
​
metadata
object
Metadati opzionali sulla chiamata API come endpoint, metodo, codice di stato, tempo di risposta, ecc.

​
Configurazione del Batch

​
maxSize
number
Numero massimo di eventi prima dell’auto-scarico. Predefinito: 100.
​
flushInterval
number
Intervallo di auto-scarico in millisecondi. Predefinito: 5000 (5 secondi).

​
Migliori Pratiche

Usa il Batching per Alto Volume: Per applicazioni che gestiscono più di 10 richieste al secondo, utilizza createBatch() per ridurre il sovraccarico e migliorare le prestazioni.
Pulisci Sempre i Batch: Chiama batch.cleanup() alla chiusura dell’applicazione per scaricare gli eventi in sospeso e prevenire la perdita di dati.