Applications
Lire et modifier la fiche de votre application, et gérer ses fonctionnalités activables par client avec l'API publique.
This page has not been translated yet and is shown in French.
La fiche d'une application porte son identité (nom, URL du front et de l'API) et le réglage de ses invitations. Les fonctionnalités de l'application sont des interrupteurs que votre code consulte pour savoir si un client y a accès. L'hébergement de l'application (environnements, services, builds) se pilote depuis la console et n'est pas couvert ici.
Note
La création et la suppression d'une application sont réservées à l'équipe Wakastart : votre application est créée par Wakastart ; contactez-nous pour en ouvrir une.
Accès commun : appelant de niveau Administrateur client (CUSTOMER_ADMIN) au minimum, avec le droit applicatif indiqué. La modification de la fiche revient au propriétaire de l'application et aux administrateurs qui lui sont rattachés.
L'objet Application
| Champ | Type | Description |
|---|---|---|
id | UUID | Identifiant technique |
wid | chaîne (6) | Identifiant court, qui sert aussi d'identifiant de client Keycloak |
partnerId | UUID | Propriétaire. Non modifiable |
name | chaîne (100) | Nom |
description | chaîne (250) ou null | Description |
type | chaîne | APP (application), MOD (module) ou SRV (service) |
urlFront | chaîne (255) ou null | URL du front. Discovery s'en sert pour limiter la recherche par e-mail |
urlApi | chaîne (255) ou null | URL de l'API de l'application |
isHds | booléen | Application hébergeant des données de santé |
status | chaîne | ACTIVE, INACTIVE, SUSPENDED, DELETED ou DRAFT |
invitationsEnabled | booléen | Invitations autorisées (défaut true) |
acceptInvitationUrl | chaîne (500) ou null | Adresse de la page d'acceptation, avec l'emplacement {token} : https://mon-app.exemple.fr/invitation/{token} |
invitationExpiryDays | entier, 1 à 365 | Validité d'une invitation, en jours (défaut 10) |
invitationPerUserLimit | entier, 1 à 10 000, ou null | Invitations maximales par inviteur sur 30 jours ; null : sans limite |
invitationVerifyEmail | booléen | Vérifie l'adresse avant d'inviter (défaut true) |
invitationNotifyInviter | booléen | Prévient l'inviteur de l'acceptation (défaut false) |
createdAt, updatedAt | chaîne ISO 8601 | Dates de création et de modification |
Lister et lire les applications
/api/config/apps/api/config/apps/{wid}Droit requis : apps.read. La liste est paginée (page, limit de 1 à 100, défaut 20) et limitée aux applications de votre périmètre.
curl -s https://api.wakastart.app/api/config/apps/EXAPP1 \
-H "Authorization: Bearer $ACCESS_TOKEN"Réponse 200
{
"id": "a1b2c3d4-0000-4000-8000-000000000001",
"wid": "EXAPP1",
"partnerId": "f0e1d2c3-4444-4b5a-9c8d-7e6f5a4b3c21",
"name": "Mon App",
"description": "Gestion des rendez-vous",
"type": "APP",
"urlFront": "https://mon-app.exemple.fr",
"urlApi": "https://api.mon-app.exemple.fr",
"isHds": false,
"status": "ACTIVE",
"invitationsEnabled": true,
"acceptInvitationUrl": "https://mon-app.exemple.fr/invitation/{token}",
"invitationExpiryDays": 10,
"invitationPerUserLimit": null,
"invitationVerifyEmail": true,
"invitationNotifyInviter": false,
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-10-01T08:20:00.000Z"
}Erreurs : 403 Accès refusé à cette application ; 404 App with WID <wid> not found.
Modifier l'application
/api/config/apps/{wid}Droit requis : apps.update. Tous les champs sont facultatifs.
| Champ | Type | Contraintes |
|---|---|---|
name | chaîne | 100 caractères au plus |
description | chaîne | 250 caractères au plus |
urlFront, urlApi | chaîne | 255 caractères au plus |
invitationsEnabled | booléen | — |
acceptInvitationUrl | chaîne | 500 caractères au plus, avec {token} |
invitationExpiryDays | entier | 1 à 365 |
invitationPerUserLimit | entier ou null | 1 à 10 000 |
invitationVerifyEmail, invitationNotifyInviter | booléen | — |
L'activation des données de santé (isHds) se fait depuis la console, qui provisionne en même temps le module HDS pour chaque client de l'application.
curl -s -X PUT https://api.wakastart.app/api/config/apps/EXAPP1 \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"acceptInvitationUrl": "https://mon-app.exemple.fr/invitation/{token}",
"invitationExpiryDays": 14
}'Réponse : l'objet Application modifié.
Erreurs : 403 Accès refusé à cette application.
L'objet Fonctionnalité
| Champ | Type | Description |
|---|---|---|
id | UUID | Identifiant |
appId | UUID | Application. Non modifiable |
code | chaîne (20) | Code unique dans l'application, que votre code teste : export-pdf |
name | chaîne (100) | Libellé |
description | chaîne (200) ou null | Description |
isPaid | booléen | Fonctionnalité payante (défaut false) |
isEnabled | booléen | Disponible dans l'application (défaut true) |
Une application compte 50 fonctionnalités au plus. Une fonctionnalité n'est active pour un client que si elle l'est pour l'application, pour son réseau et pour le client lui-même ; l'activation par réseau et par client se fait dans la console.
Savoir si une fonctionnalité est active pour un client
/api/config/app-features/check/{customerWid}/{featureCode}Droit requis : apps.features.read.
curl -s https://api.wakastart.app/api/config/app-features/check/EXCLI1/export-pdf \
-H "x-api-key: sk_test_exemple"Réponse 200
{ "featureCode": "export-pdf", "customerId": "c3d5e7f9-2b4c-4d6e-9f0a-1b2c3d4e5f60", "isEnabled": true }/api/config/app-features/enabled/{customerWid}Droit requis : apps.features.read. Renvoie les codes de toutes les fonctionnalités actives pour le client :
{ "customerId": "c3d5e7f9-2b4c-4d6e-9f0a-1b2c3d4e5f60", "features": ["export-pdf", "agenda-partage"] }Le jeton de l'utilisateur ne porte pas ses fonctionnalités : interrogez ces endpoints depuis votre serveur, et gardez le résultat en cache quelques minutes.
Lister les fonctionnalités
/api/config/app-features/by-app/{appWid}Droit requis : apps.features.read. Renvoie le tableau des fonctionnalités de l'application. GET /api/config/app-features (paginé) et GET /api/config/app-features/{id} lisent avec le même droit.
Créer, modifier ou supprimer une fonctionnalité
/api/config/app-featuresDroit requis : apps.features.toggle.
| Champ | Type | Obligatoire | Contraintes |
|---|---|---|---|
appId | UUID | oui | Application |
code | chaîne | oui | 20 caractères au plus, unique dans l'application |
name | chaîne | oui | 100 caractères au plus |
description | chaîne | non | 200 caractères au plus |
isPaid | booléen | non | Défaut false |
isEnabled | booléen | non | Défaut true |
curl -s -X POST https://api.wakastart.app/api/config/app-features \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"appId": "a1b2c3d4-0000-4000-8000-000000000001",
"code": "export-pdf",
"name": "Export PDF"
}'Réponse 201 : l'objet Fonctionnalité créé.
/api/config/app-features/{id}/api/config/app-features/{id}Droit requis : apps.features.toggle. La modification accepte les champs de la création, tous facultatifs, sauf appId.
Erreurs : 409 Maximum 50 features allowed per app ; 409 Feature with code '<code>' already exists for this app ; 403 App feature not found or not accessible.