# Applications

> Lire et modifier la fiche de votre application, et gérer ses fonctionnalités activables par client avec l'API publique.

La fiche d'une [application](/v1.0/glossaire#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](/v1.0/reference-api/discovery#retrouver-les-comptes-dun-e-mail-pour-votre-front) |
| `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

::endpoint{method="GET" path="/api/config/apps"}

::endpoint{method="GET" path="/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.

```bash
curl -s https://api.wakastart.app/api/config/apps/EXAPP1 \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

**Réponse `200`**

```json
{
  "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

::endpoint{method="PUT" path="/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.

```bash
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

::endpoint{method="GET" path="/api/config/app-features/check/{customerWid}/{featureCode}"}

**Droit requis** : `apps.features.read`.

```bash
curl -s https://api.wakastart.app/api/config/app-features/check/EXCLI1/export-pdf \
  -H "x-api-key: sk_test_exemple"
```

**Réponse `200`**

```json
{ "featureCode": "export-pdf", "customerId": "c3d5e7f9-2b4c-4d6e-9f0a-1b2c3d4e5f60", "isEnabled": true }
```

::endpoint{method="GET" path="/api/config/app-features/enabled/{customerWid}"}

**Droit requis** : `apps.features.read`. Renvoie les codes de toutes les fonctionnalités actives pour le client :

```json
{ "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

::endpoint{method="GET" path="/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é

::endpoint{method="POST" path="/api/config/app-features"}

**Droit 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` |

```bash
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éé.

::endpoint{method="PATCH" path="/api/config/app-features/{id}"}

::endpoint{method="DELETE" path="/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`.
