Docs Identity and access Organizations Référence des organisations Référence des organisations Champs, limites et statuts des propriétaires, applications, réseaux, clients, entités, contacts et fonctionnalités, avec les écrans et les opérations d'API.
Reference Administrator Partner Developer
Updated on 23 October 2026
This page has not been translated yet and is shown in French.
Cette page décrit les objets de l'organisation Wakastart. Le détail de chaque endpoint (paramètres, codes de réponse) est dans la référence API des organisations . Les concepts sont expliqués dans Modèle d'organisation .
Identifiant court (WID)#
Propriété Valeur Format 6 caractères 0-9, a-z, A-Z, par exemple aB3dE9 Unicité Par type d'objet Modification Jamais Validation dans les URL Un WID mal formé renvoie 400
Statuts#
Propriétaires, applications, réseaux et clients portent un status :
Valeur API Libellé de la console ACTIVE (par défaut)Actif INACTIVEInactif SUSPENDEDSuspendu DRAFTBrouillon
Propriétaire#
Champ Type Contraintes Description widchaîne 6 caractères Identifiant court namechaîne 100 caractères, obligatoire Nom (console : Nom ) descriptionchaîne 250 caractères Description statusstatut ACTIVE par défautStatut entityIdUUID facultatif Entité juridique rattachée
Application#
L'application est créée par Wakastart. Les champs utiles à un partenaire :
Champ Type Contraintes Description widchaîne 6 caractères Identifiant court, et identifiant du client OIDC dans Keycloak namechaîne 100 caractères Nom shortnamechaîne 3 à 12 caractères a-z0-9, unique, non modifiable Nom court (par défaut le WID en minuscules) typeénumération APP, MOD, SRVType, affiché en badge dans l'en-tête de l'application urlFront, urlApiURL 255 caractères URL du front et de l'API de l'application invitationsEnabled et champs invitation*divers voir Configurer les invitations Réglages des invitations
Réseau#
Champ Type Contraintes Description widchaîne 6 caractères Identifiant court appIdUUID obligatoire, non modifiable Application distribuée namechaîne 100 caractères, obligatoire Nom descriptionchaîne 250 caractères Description subdomainchaîne 15 caractères, minuscules, unique sur la plateforme URL Shortener realmIdchaîne realm-<wid>Realm ID (Keycloak) , fixé à la créationdefLangId, defThemeIdUUID facultatifs Langue par défaut , Thème par défaut , hérités par les clientsentityIdUUID facultatif Entité juridique
Client#
Champ Type Contraintes Description widchaîne 6 caractères Identifiant court, nom du groupe et alias de l'organisation Keycloak networkIdUUID obligatoire, non modifiable Réseau du client namechaîne 100 caractères, obligatoire Nom descriptionchaîne 250 caractères Description entityIdUUID obligatoire à la création par l'API Entité juridique subdomainchaîne 15 caractères a-z0-9- par l'API, unique Sous-domaine court defLangId, defThemeIdUUID facultatifs Langue et thème par défaut, qui remplacent ceux du réseau
Entité juridique#
Champ Libellé de la console Contraintes entityNameNom d'usage 100 caractères, obligatoire legalNameRaison sociale 250 caractères legalCountryPays code pays à 2 lettres, FR par défaut legalFormForme juridique businessRegistrationIdSIREN (France)50 caractères commercialRegistryNumberRCS (France)100 caractères vatNumberN° TVA intracommunautaire 50 caractères fiscalYearEndDate de fin d'exercice fiscal 20 caractères addressRue , Complément (optionnel) , Complément 2 (optionnel) , Code postal , Ville , Pays (adresse)
Champ Libellé de la console Contraintes entityIdEntité obligatoire civilityCivilité firstName, lastNamePrénom , Nom 100 caractères chacun, obligatoires emailEmail 255 caractères, obligatoire jobTitleFonction 100 caractères phone, mobileTéléphone , Mobile 20 caractères chacun isBillingContactbadge Facturation booléen
Fonctionnalité#
Champ Libellé de la console Contraintes codeCode unique dans l'application, non modifiable ; 50 caractères dans la console, 20 par l'API publique nameNom 100 caractères, obligatoire descriptionDescription 200 caractères par l'API publique isPaidFeature premium (payante) false par défautisEnabled(API) interrupteur d'application, true par défaut
Une application compte 50 fonctionnalités au plus.
Écrans de la console#
Écran Chemin Accès Tableau de bord menu latéral Administrateur client ou supérieur Propriétaires Administration > Propriétaires Propriétaire Entités & Contacts Administration > Entités & Contacts Propriétaire Réseaux Administration > Réseaux Administrateur réseau (droit networks.read) ou supérieur Fiche d'un réseau Réseaux > Configuration avancée idem ; onglets Général , Profils , App Features , Langues , Thème , Modules Crédits , Email Paramétrage d'une applicationmenu latéral, sous le nom de l'application droit apps.read (profils Développeur et Infra ) ou Administrateur d'applications Onglet Features Paramétrage > Features lecture avec l'accès au paramétrage ; écriture avec apps.features.toggle
Opérations de l'API publique#
URL de base : https://api.wakastart.app/api. Toutes ces opérations exigent le niveau Administrateur client au moins, en plus du droit indiqué.
Opération Méthode et chemin Droit Lister, consulter les propriétaires GET /config/partners, GET /config/partners/{wid}partners.readModifier un propriétaire PUT /config/partners/{wid}partners.updateLister, consulter les applications GET /config/apps, GET /config/apps/{wid}apps.readLister, consulter les réseaux GET /config/networks, GET /config/networks/{wid}networks.readCréer, modifier un réseau POST /config/networks, PUT /config/networks/{wid}networks.create, networks.updateLister, consulter les clients GET /config/customers, GET /config/customers/{wid}customers.readCréer, modifier, supprimer un client POST /config/customers, PUT et DELETE /config/customers/{wid}customers.create, customers.update, customers.deleteLister les fonctionnalités GET /config/app-features, GET /config/app-features/by-app/{appWid}apps.features.readDéclarer, modifier, supprimer une fonctionnalité POST /config/app-features, PATCH et DELETE /config/app-features/{id}apps.features.toggleVérifier une fonctionnalité GET /config/app-features/check/{customerWid}/{featureCode}, GET /config/app-features/enabled/{customerWid}apps.features.read
Les listes acceptent page (à partir de 1) et limit (de 1 à 100, 20 par défaut), et renvoient { "data": [...], "meta": { "page", "limit", "total", "totalPages" } }. Un champ inconnu dans un corps de requête est refusé avec une erreur 400.