Référence des points de terminaison

Tous les chemins servis par l'API REST de Sovrium. Le modèle d'authentification, l'enveloppe d'erreur et les comportements transversaux qui les régissent tous se trouvent dans la Présentation de l'API REST.

Santé

Vérification de santé du serveur, non authentifiée.

Méthode	Chemin	Description
GET	/api/health	Vérifier l'état du serveur

Tables

Lire les définitions de tables et gérer les webhooks de table sortants.

Méthode	Chemin	Description
GET	/api/tables	Lister toutes les tables
GET	/api/tables/{tableId}	Obtenir une table par ID
GET	/api/tables/{tableId}/permissions	Obtenir les permissions
GET	/api/tables/{tableId}/export	Exporter les enregistrements en CSV
GET	/api/tables/{tableId}/webhooks	Lister les webhooks de table
POST	/api/tables/{tableId}/webhooks/{webhookName}/test	Envoyer une livraison de test
GET	/api/tables/{tableId}/webhooks/{webhookName}/deliveries	Lister les livraisons
GET	.../deliveries/{deliveryId}	Obtenir une livraison
POST	.../deliveries/{deliveryId}/retry	Réessayer une livraison

Enregistrements

CRUD complet, opérations par lot, cycle de suppression douce, historique des révisions, commentaires et temps réel. Voir la Présentation des enregistrements pour le modèle de données.

CRUD

Méthode	Chemin	Description
GET	/api/tables/{tableId}/records	Lister les enregistrements
POST	/api/tables/{tableId}/records	Créer un enregistrement
GET	/api/tables/{tableId}/records/{recordId}	Obtenir un enregistrement par ID
PATCH	/api/tables/{tableId}/records/{recordId}	Mettre à jour un enregistrement
DELETE	/api/tables/{tableId}/records/{recordId}	Supprimer un enregistrement

DELETE supprime en douceur par défaut ; ?permanent=true (administrateur uniquement) et ?purge=true suppriment définitivement sur la même route. Deux équivalents en POST existent pour les formulaires HTML : POST .../records/{recordId}/update et POST .../records/{recordId}/delete.

Opérations par lot

Méthode	Chemin	Description
POST	/api/tables/{tableId}/records/batch	Créer plusieurs enregistrements (1–1000)
PATCH	/api/tables/{tableId}/records/batch	Mettre à jour plusieurs enregistrements (1–100)
DELETE	/api/tables/{tableId}/records/batch	Supprimer en douceur plusieurs (1–100)
POST	/api/tables/{tableId}/records/batch/delete	Suppression douce, verbe alternatif
POST	/api/tables/{tableId}/records/batch/restore	Restaurer plusieurs enregistrements (1–100)
POST	/api/tables/{tableId}/records/upsert	Créer ou mettre à jour (1–100)

POST .../records/batch-delete est conservé comme alias hérité, et POST .../records/bulk-delete / bulk-update sous-tendent les soumissions de formulaires HTML.

Corbeille et historique

Méthode	Chemin	Description
GET	/api/tables/{tableId}/trash	Lister les enregistrements en corbeille
POST	/api/tables/{tableId}/records/{recordId}/restore	Restaurer un enregistrement supprimé
GET	/api/tables/{tableId}/records/{recordId}/history	Obtenir l'historique des révisions

Commentaires

Méthode	Chemin	Description
GET	/api/tables/{tableId}/records/{recordId}/comments	Lister les commentaires
POST	/api/tables/{tableId}/records/{recordId}/comments	Ajouter un commentaire
POST	/api/tables/{tableId}/records/{recordId}/comments/read	Marquer les commentaires comme lus
GET	.../{recordId}/comments/{commentId}	Obtenir un commentaire par ID
PATCH	.../{recordId}/comments/{commentId}	Mettre à jour un commentaire
DELETE	.../{recordId}/comments/{commentId}	Supprimer un commentaire

Temps réel

Méthode	Chemin	Description
GET	/api/tables/{tableId}/subscribe	S'abonner aux changements
GET	/api/tables/{tableId}/subscribe/sse	Flux d'événements côté serveur
GET	/api/realtime/presence	Informations de présence courantes

Vues

Vues préconfigurées qui filtrent, trient et regroupent les enregistrements d'une table.

Méthode	Chemin	Description
GET	/api/tables/{tableId}/views	Lister les vues d'une table
GET	/api/tables/{tableId}/views/{viewId}	Obtenir une vue par ID
GET	/api/tables/{tableId}/views/{viewId}/records	Obtenir les enregistrements via une vue

Contrairement à ?view= sur la liste des enregistrements, ce point de terminaison applique la configuration complète de la vue, y compris sa sélection de champs et son regroupement — voir Regroupement et vues enregistrées.

Activité

Journal d'audit des changements de données sur toutes les tables.

Méthode	Chemin	Description
GET	/api/activity	Lister les entrées d'activité
GET	/api/activity/{activityId}	Obtenir le détail d'une activité

Analytique

Analytique d'usage respectueuse de la vie privée, sans cookies.

Méthode	Chemin	Description
POST	/api/analytics/collect	Collecter un événement de page vue
GET	/api/analytics/overview	Obtenir la vue d'ensemble
GET	/api/analytics/pages	Obtenir les pages les plus vues
GET	/api/analytics/referrers	Obtenir les référents principaux
GET	/api/analytics/devices	Obtenir la répartition par appareil
GET	/api/analytics/campaigns	Obtenir les statistiques de campagne
GET	/api/analytics/events	Obtenir les événements personnalisés

Authentification

L'authentification est assurée par Better Auth et montée sur /api/auth/* — e-mail/mot de passe, OAuth social, sessions, réinitialisation de mot de passe, vérification d'e-mail, deux facteurs, liens magiques, OTP par e-mail, organisations et gestion des utilisateurs. Voir la Présentation de l'authentification pour la configuration.

Quelques routes sont servies directement plutôt que par Better Auth :

Méthode	Chemin	Description
PATCH	/api/auth/user/update	Mettre à jour le profil de l'utilisateur
POST	/api/auth/session/refresh	Rafraîchir la session active
PATCH	/api/auth/admin/users/{id}	Mise à jour administrative d'un utilisateur
GET	/api/auth/organization/list-teams	Lister les équipes d'une organisation
POST	/api/auth/organization/add-team-member	Ajouter un membre à une équipe

Les administrateurs peuvent parcourir la surface complète lisible par machine sur /api/scalar et récupérer les documents OpenAPI bruts — voir OpenAPI.

Pages associées

• Présentation de l'API REST — authentification, contrat d'erreur, règles transversales.
• Créer, lire et mettre à jour — corps de requête et de réponse des routes d'enregistrements.
• Filtrage, tri et pagination — la grammaire des requêtes de liste.
• OpenAPI — le document généré et le navigateur Scalar.
• Webhooks de table — configurer les routes de webhooks ci-dessus.