# Définir les fonctionnalités de votre application

> Déclarer les fonctionnalités activables de votre application, les modifier, les couper globalement ou les supprimer.

Déclarez ici chaque fonctionnalité que votre application doit pouvoir activer ou couper selon le client : un module, une option, une offre premium. Le code que vous choisissez est celui que votre application interrogera ensuite.

## Avant de commencer

- Vous avez le droit `apps.features.toggle` (le profil client **Infra** le porte) ou le niveau Propriétaire. La lecture seule demande `apps.features.read`.
- Choisissez des codes courts et stables, par exemple `analytics` ou `export-pdf` : un code ne se modifie plus après la création.
- Une application compte 50 fonctionnalités au plus.

## Déclarer une fonctionnalité

:::::tabs{sync="voie"}
::::tab{label="Console"}
:::steps
### Ouvrir le paramétrage

Dans le menu latéral, sous le nom de votre application, cliquez sur **Paramétrage**, puis ouvrez l'onglet **Features**.

Résultat : la carte **Fonctionnalités** liste les fonctionnalités déclarées, ou « Aucune feature définie ».

### Créer la fonctionnalité

Cliquez sur **Nouvelle feature**, puis renseignez :

- **Code** : l'identifiant lu par votre application, par exemple `analytics` ;
- **Nom** : le libellé affiché ;
- **Description** : facultative ;
- **Feature premium (payante)** : cochez si la fonctionnalité fait partie d'une offre payante. La console affiche alors le badge **Premium**.

### Enregistrer

Cliquez sur **Créer**.

Résultat : le message « Feature créée » s'affiche. La fonctionnalité est active au niveau de l'application.
:::
::::

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

`appId` est l'UUID de votre application. Par l'API publique, `code` fait 20 caractères au plus et `description` 200.

```bash
curl -X POST "https://api.wakastart.app/api/config/app-features" \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "code": "analytics",
    "name": "Statistiques avancées",
    "description": "Tableaux de bord et exports",
    "isPaid": true
  }'
```

```ts
const response = await fetch("https://api.wakastart.app/api/config/app-features", {
  method: "POST",
  headers: { "x-api-key": "sk_test_exemple", "Content-Type": "application/json" },
  body: JSON.stringify({
    appId: "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    code: "analytics",
    name: "Statistiques avancées",
    description: "Tableaux de bord et exports",
    isPaid: true,
  }),
});
const feature = await response.json();
```

Réponse attendue (extrait) :

```json
{
  "id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
  "code": "analytics",
  "name": "Statistiques avancées",
  "isPaid": true,
  "isEnabled": true
}
```
::::
:::::

## Modifier, couper ou supprimer une fonctionnalité

:::::tabs{sync="voie"}
::::tab{label="Console"}
1. Dans **Paramétrage** > **Features**, cliquez sur l'icône de modification de la fonctionnalité.
2. Changez le **Nom**, la **Description** ou **Feature premium (payante)**, puis cliquez sur **Mettre à jour**. Le **Code** reste grisé : « Le code ne peut pas être modifié ».
3. Pour supprimer, cliquez sur l'icône corbeille et confirmez « Êtes-vous sûr de vouloir supprimer cette feature ? ».
::::

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

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

Pour couper une fonctionnalité chez tous les clients sans la supprimer, éteignez son interrupteur d'application :

```bash
curl -X PATCH "https://api.wakastart.app/api/config/app-features/9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f" \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{ "isEnabled": false }'
```

```ts
await fetch(
  "https://api.wakastart.app/api/config/app-features/9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
  {
    method: "PATCH",
    headers: { "x-api-key": "sk_test_exemple", "Content-Type": "application/json" },
    body: JSON.stringify({ isEnabled: false }),
  },
);
```

Réponse attendue : la fonctionnalité avec `"isEnabled": false`. Les champs modifiables sont `name`, `description`, `isPaid` et `isEnabled`.
::::
:::::

## Vérifier le résultat

Listez les fonctionnalités de l'application :

```bash
curl "https://api.wakastart.app/api/config/app-features/by-app/aB3dE9" \
  -H "x-api-key: sk_test_exemple"
```

La réponse contient votre fonctionnalité avec son `code`. Dans la console, elle apparaît dans l'onglet **Features** avec son badge de code.

## Voir aussi

- [Fonctionnalités activables](/v1.0/organisations/fonctionnalites-activables)
- [Vérifier qu'une fonctionnalité est active](/v1.0/organisations/verifier-une-fonctionnalite)
- [Résoudre les problèmes d'organisation](/v1.0/organisations/depannage#maximum-50-features-allowed-per-app)
