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.
- Accès requis
- Droit apps.features.toggle (profil Infra) ou Propriétaire
- Durée
- 5 min
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 demandeapps.features.read. - Choisissez des codes courts et stables, par exemple
analyticsouexport-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.
/api/config/app-featuresappId est l'UUID de votre application. Par l'API publique, code fait 20 caractères au plus et description 200.
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
}'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) :
{
"id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
"code": "analytics",
"name": "Statistiques avancées",
"isPaid": true,
"isEnabled": true
}Modifier, couper ou supprimer une fonctionnalité
- Dans Paramétrage > Features, cliquez sur l'icône de modification de la fonctionnalité.
- 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é ».
- Pour supprimer, cliquez sur l'icône corbeille et confirmez « Êtes-vous sûr de vouloir supprimer cette feature ? ».
/api/config/app-features/{id}/api/config/app-features/{id}Pour couper une fonctionnalité chez tous les clients sans la supprimer, éteignez son interrupteur d'application :
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 }'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 :
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.