Skip to content

Équipes

Créer des équipes dans un client, y ajouter des membres et régler leur niveau et leurs droits d'équipe par l'API publique.

ReferenceDeveloperAdministrator

This page has not been translated yet and is shown in French.

Une équipe regroupe des utilisateurs d'un même client. Chaque membre y a un niveau d'équipe et, en option, des droits d'équipe codés par des lettres que votre application interprète. Votre serveur peut ensuite contrôler l'appartenance d'un utilisateur avec POST /api/token/check/team.

Accès commun : appelant de niveau Administrateur client (CUSTOMER_ADMIN) au minimum, avec le droit applicatif indiqué. Les modifications exigent en plus un niveau suffisant dans l'équipe : MANAGER au moins pour modifier l'équipe et gérer ses membres, ADMIN pour la supprimer.

L'objet Équipe

ChampTypeDescription
idUUIDIdentifiant technique
widchaîne (6)Identifiant court
customerIdUUIDClient de l'équipe
namechaîne (100)Nom
descriptionchaîne ou nullDescription
createdAt, updatedAtchaîne ISO 8601Dates de création et de modification

Niveaux d'équipe

NiveauChiffreCe que le membre peut faire
ADMIN1Tout sur l'équipe : la renommer, la supprimer, gérer ses membres et ses données
MANAGER2Gérer les membres et toutes les données
MEMBER3Ajouter, modifier, supprimer et voir les données (niveau par défaut)
CONTRIBUTOR4Ajouter et voir les données
VIEWER5Voir les données
NONE0Aucun droit

Ce que recouvrent « les données » d'une équipe est défini par votre application. Les droits d'équipe (appRights) sont une chaîne de 52 lettres au plus, de A à Z et de a à z, dont votre application fixe la signification.

Lister les équipes

GET/api/config/teams

Droit requis : teams.read. Pagination page et limit (1 à 100, défaut 20), filtres de portée customerWid ou customerId.

Bash
curl -s "https://api.wakastart.app/api/config/teams?customerWid=EXCLI1" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Réponse 200

JSON
{
  "data": [
    {
      "id": "f6a8b0c2-5e7f-4a91-8c3d-4e5f6a7b8c90",
      "wid": "EXTEA1",
      "customerId": "c3d5e7f9-2b4c-4d6e-9f0a-1b2c3d4e5f60",
      "name": "Accueil",
      "description": "Équipe d'accueil des patients",
      "createdAt": "2026-04-02T09:30:00.000Z",
      "updatedAt": "2026-04-02T09:30:00.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "totalPages": 1 }
}

Lire une équipe

GET/api/config/teams/{wid}

Droit requis : teams.read. Réponse : l'objet Équipe.

Erreurs : 403 Team not found or not accessible ; 404 Team with WID <wid> not found.

Créer une équipe

POST/api/config/teams

Droit requis : teams.create.

ChampTypeObligatoireContraintes
namechaîneoui100 caractères au plus
customerIdUUIDnonClient de l'équipe
descriptionchaînenon—
Bash
curl -s -X POST https://api.wakastart.app/api/config/teams \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Cardiologie", "description": "Service de cardiologie" }'

Réponse 201 : l'objet Équipe créé.

Modifier une équipe

PUT/api/config/teams/{wid}

Droit requis : teams.update. Champs facultatifs : name (100 caractères au plus), description.

Erreurs : 403 Vous n'avez pas les droits pour modifier cette équipe.

Supprimer une équipe

DELETE/api/config/teams/{wid}

Droit requis : teams.delete. Retirez d'abord tous les membres.

Erreurs : 403 Vous n'avez pas les droits pour supprimer cette équipe ; 409 Impossible de supprimer cette équipe car elle possède encore des membres. Retirez d'abord les membres de l'équipe.

Lister les membres d'une équipe

GET/api/config/teams/{wid}/members

Droit requis : teams.read. Renvoie un tableau, sans pagination : un élément par membre, avec son niveau, ses droits d'équipe et sa fiche utilisateur.

Bash
curl -s https://api.wakastart.app/api/config/teams/EXTEA1/members \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Réponse 200

JSON
[
  {
    "userId": "e5f7a9b1-4d6e-4f80-9b2c-3d4e5f6a7b80",
    "teamId": "f6a8b0c2-5e7f-4a91-8c3d-4e5f6a7b8c90",
    "teamLevel": "MANAGER",
    "appRights": "AB",
    "user": {
      "id": "e5f7a9b1-4d6e-4f80-9b2c-3d4e5f6a7b80",
      "wid": "EXUSR1",
      "email": "alice@clinique-exemple.fr",
      "firstName": "Alice",
      "lastName": "Martin",
      "isActive": true
    }
  }
]

L'objet user reprend les champs de l'objet Utilisateur ; l'exemple n'en montre qu'une partie.

Ajouter un membre

POST/api/config/teams/{wid}/members

Droit requis : teams.members.add.

ChampTypeObligatoireContraintesDescription
userIdUUIDouiUtilisateur du même clientUtilisateur à ajouter
teamLevelchaînenonADMIN, MANAGER, MEMBER, CONTRIBUTOR, VIEWER, NONEDéfaut MEMBER
appRightschaînenon52 lettres au plus, ^[a-zA-Z]*$Droits d'équipe
Bash
curl -s -X POST https://api.wakastart.app/api/config/teams/EXTEA1/members \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "userId": "e5f7a9b1-4d6e-4f80-9b2c-3d4e5f6a7b80",
    "teamLevel": "CONTRIBUTOR",
    "appRights": "AB"
  }'

Erreurs : 403 Vous n'avez pas les droits pour ajouter des membres à cette équipe ; 409 La valeur du champ "<champs>" existe déjà. Veuillez en choisir une autre. : l'utilisateur est déjà membre.

Modifier le niveau d'un membre

PATCH/api/config/teams/{teamWid}/members/{userWid}/role

Droit requis : teams.members.add.

ChampTypeObligatoireContraintes
teamLevelchaîneouiADMIN, MANAGER, MEMBER, CONTRIBUTOR, VIEWER, NONE
appRightschaînenon52 lettres au plus
Bash
curl -s -X PATCH https://api.wakastart.app/api/config/teams/EXTEA1/members/EXUSR2/role \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "teamLevel": "MANAGER" }'

Erreurs : 403 Vous n'avez pas les droits pour modifier les niveaux dans cette équipe.

Retirer un membre

DELETE/api/config/teams/{teamWid}/members/{userWid}

Droit requis : teams.members.add.

Erreurs : 403 Vous n'avez pas les droits pour retirer des membres de cette équipe.