Serveur de développement local

La commande lomi dev démarre un serveur HTTP léger qui reçoit les requêtes POST webhook et affiche les événements dans le terminal.

Pour de vrais webhooks sandbox sans ngrok, préférez lomi listen.

Nécessite lomi login.

Usage

lomi dev

URL par défaut : http://localhost:4242/webhook

Options

Option	Défaut	Description
`-p, --port`	`4242`	Port du serveur HTTP
`--env-file`	`.env`	Fichier dotenv à charger
`--verify-signature`	auto si `LOMI_WEBHOOK_SECRET` est défini	Vérifier `X-Lomi-Signature` avec `LOMI_WEBHOOK_SECRET`
`--skip-rules-install`	-	Ignorer l’invite d’installation des règles agent

lomi dev --port 3000
lomi dev --verify-signature

Endpoints

Méthode	Chemin	Description
`POST`	`/webhook`	Reçoit les charges utiles d’événements webhook
`GET`	`/health`	Retourne `ok`

Test local

Démarrer le serveur de dev

lomi dev

Envoyer un événement de test

curl -X POST http://localhost:4242/webhook \
  -H "Content-Type: application/json" \
  -d '{"type":"test.event","data":{}}'

Le CLI affiche le type d’événement et la charge utile dans le terminal.

Recevoir de vrais événements sandbox (recommandé)

lomi listen http://localhost:4242/webhook

Vérification de signature

Lorsque la vérification est activée, le serveur valide l’en-tête X-Lomi-Signature contre LOMI_WEBHOOK_SECRET de votre fichier .env.

Assurez-vous que LOMI_WEBHOOK_SECRET est défini avant d’activer la vérification :

LOMI_WEBHOOK_SECRET=whsec_your_secret_here

Pour les modèles de traitement webhook en production, voir Traiter les webhooks et Référence webhooks.

Lien avec `lomi init`

Après lomi init, lomi dev charge les identifiants depuis le .env du projet. L’exemple généré examples/webhook-handler.ts montre comment implémenter la vérification dans votre propre code.