API Reference

Chaque SaaS expose son OpenAPI 3.1 et sa documentation Redoc interactive. Cliquez sur l'API qui vous intéresse pour ouvrir la documentation Redoc complète.

Spec OpenAPI par SaaS

Commertra — Encaissement NF525, POS, fidélité, livre de policehttps://app.commertra.servolution.fr/openapi.json Comptentra — Comptabilité, FEC, Factur-X, DAS2https://app.comptentra.servolution.fr/openapi.json Moventra — WMS, stock, expéditions, transporthttps://app.moventra.servolution.fr/openapi.json Pooleau — Pisciniers, devis, intervention, bilan eauhttps://app.pooleau.servolution.fr/openapi.json Bâtitra — Artisans BTP, MaPrimeRénov, garantieshttps://app.batitra.servolution.fr/openapi.json Weboria — E-commerce, marketplace, vendeurshttps://app.weboria.servolution.fr/openapi.json Pilotage SD — Trésorerie, budget, multi-sociétéshttps://app.strategiedirigeants.com/openapi.json

Conventions communes

Base URL : https://app.<saas>.servolution.fr
Préfixe API : /api/v1/
Format : JSON (request + response)
Encodage : UTF-8
Dates : ISO 8601 UTC (2026-05-10T01:23:45Z)
Montants : centimes entiers (price_cents: 1990 pour 19,90 €)
Pagination : ?page=1&page_size=50 (max 200)
Erreurs : { "detail": "message", "code": "VALIDATION_ERROR" }

Endpoints transverses (présents sur les 7 SaaS)

Endpoint	Méthode	Auth	Description
`/api/v1/api-keys`	GET	JWT user	Liste mes clés API
`/api/v1/api-keys`	POST	JWT user	Crée une clé (label, scopes, tier, expiration)
`/api/v1/api-keys/{id}`	DELETE	JWT user	Révoque une clé
`/api/v1/public/ping`	GET	X-API-Key	Ping authentifié + headers RateLimit
`/api/v1/public/whoami`	GET	X-API-Key	Renvoie tier, scopes, company_id
`/api/v1/health`	GET	aucune	Healthcheck (status, ts)