Record a usage event

Aperçu

Record a usage event

Idempotent usage ingest. Events are processed asynchronously and update meter balances.

Quand l’utiliser

Utilisez cet endpoint quand vous devez exécuter POST /usage-events (Record a usage event).

Authentification

Les routes marchandes nécessitent une clé API dans l’en-tête X-API-KEY (voir Vue d’ensemble). Utilisez une clé test avec https://sandbox.api.lomi.africa et une clé live avec https://api.lomi.africa.

Endpoint

POST /usage-events

URLs de base :

• https://sandbox.api.lomi.africa
• https://api.lomi.africa

Requête

Paramètres d’URL

Pas d’autre paramètre dans l’URL.

Paramètres de requête

Aucun paramètre de requête.

Corps de la requête

Pas de corps JSON pour cette opération.

Réponses

Erreurs

Les erreurs suivent un format JSON standard. 401 : clé manquante ou invalide. 404 : ressource introuvable. 429 : trop de requêtes. Pour les créations, envoyez une clé d’idempotence si votre flux le permet.

Exemple

curl -sS -X POST "https://sandbox.api.lomi.africa/usage-events" \
  -H "X-API-KEY: $LOMI_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

OpenAPI

• operationId: UsageEventsController_ingest
• Operation: POST /usage-events

Schémas complets et Try it : référence API.