Aller au contenu

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.

GuidePartenaireAdministrateurDéveloppeur
Accès requis
Droit apps.features.toggle (profil Infra) ou Propriétaire
Durée
5 min
Voir en Markdown

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é

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.

POST/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
  }'
TypeScript
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é

  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 ? ».
PATCH/api/config/app-features/{id}
DELETE/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 }'
TypeScript
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