Utilisateurs

L’objet utilisateur représente les membres créés dans l’espace de travail. Tous les utilisateurs se voient attribuer un rank tel que owner, admin ou normal.

L’objet utilisateur

{
  "id": "802b09f1-645b-493f-bae7-672a2b315204",
  "createdAt": "2025-03-07T13:22:07.552Z",
  "updatedAt": "2025-03-07T13:22:07.726Z",
  "activeAt": null,
  "firstName": "Test",
  "lastName": "Tester",
  "email": "test@test.com",
  "rank": 5000,
  "stats": {
    "likes": 0,
    "ideas": 3,
    "missions": 3,
    "assignments": 0
  },
  "avatar": {
    "url": {
      "thumbnail": "https://uploads.staging.ideanote.dev/static/icons/beam/v1/237.svg"
    }
  }
}

Champs

Champ	Type	Description
identifiant	`string`	L’identifiant unique de l’utilisateur.
createdAt	`ISODate`	La date de création de l’utilisateur.
updatedAt	`ISODate`	La date de dernière mise à jour de l’utilisateur.
activeAt	`ISODate`	La date de dernière activité de l’utilisateur.
firstName	`string`	Le prénom de l’utilisateur.
lastName	`string`	Le nom de famille de l’utilisateur.
adresse e-mail	`string`	L’adresse e-mail de l’utilisateur.
rang	`number`	Le rang de l’utilisateur.
stats.likes	`number`	Le nombre de mentions J’aime que l’utilisateur a attribuées.
stats.ideas	`number`	Le nombre d’idées créées par l’utilisateur.
stats.missions	`number`	Le nombre de missions créées par l’utilisateur.
stats.assignments	`number`	Le nombre d’idées auxquelles l’utilisateur est affecté.
avatar	Média	L’avatar de l’utilisateur.

Rang	Description
1000	Invité
2000	Normal
3000	Administrateur
5000	Propriétaire

Lister les utilisateurs

curl -X GET "https://api.ideanote.io/v1/users?fields=id" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"

const result = await fetch("https://api.ideanote.io/v1/users?fields=id", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const users = await result.json();

La commande ci-dessus renvoie un JSON structuré comme suit :

[
  {},
  {}
]

Ce point de terminaison répertorie les utilisateurs.

Requête HTTP

GET /v1/users

Obtenir un utilisateur

curl -X GET "https://api.ideanote.io/v1/users/802b09f1-645b-493f-bae7-672a2b315204?fields=id" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"

const result = await fetch("https://api.ideanote.io/v1/users/802b09f1-645b-493f-bae7-672a2b315204?fields=id", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const user = await result.json();

La commande ci-dessus renvoie un JSON structuré comme suit :

{}

Ce point de terminaison récupère un utilisateur spécifique.

Requête HTTP

GET /v1/users/:user_id

Paramètres de requête

Paramètre	Description
user_id	L’ID de l’utilisateur à récupérer

Créer un utilisateur

curl -X POST "https://api.ideanote.io/v1/users?fields=id" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>" \
     -d '{"email":"new_user@test.com","firstName":"New","lastName":"User"}'

const result = await fetch("https://api.ideanote.io/v1/users?fields=id", {
  method: "POST",
  body: {
    "email": "new_user@test.com",
    "firstName": "New",
    "lastName": "User"
  },
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const users = await result.json();

La commande ci-dessus renvoie un JSON structuré comme suit :

{}

Ce point de terminaison crée un nouvel utilisateur.

Requête HTTP

POST /v1/users

Mettre à jour l’utilisateur

curl -X PUT "https://api.ideanote.io/v1/users/802b09f1-645b-493f-bae7-672a2b315204?fields=id" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>" \
     -d '{"firstName":"Bob"}'

const result = await fetch("https://api.ideanote.io/v1/users/802b09f1-645b-493f-bae7-672a2b315204?fields=id", {
  method: "PUT",
  body: {
    "firstName": "Bob"
  },
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const user = await result.json();

La commande ci-dessus renvoie un JSON structuré comme suit :

{}

Ce point de terminaison met à jour un utilisateur spécifique

Requête HTTP

PUT /v1/users/:user_id

Paramètres de requête

Paramètre	Description
user_id	L’ID de l’utilisateur à mettre à jour

Supprimer l’utilisateur

curl -X DELETE "https://api.ideanote.io/v1/users/802b09f1-645b-493f-bae7-672a2b315204" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"

const result = await fetch("https://api.ideanote.io/v1/users/802b09f1-645b-493f-bae7-672a2b315204", {
  method: "DELETE",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

Ce point de terminaison supprime un utilisateur spécifique

Requête HTTP

DELETE /v1/users/:user_id

Paramètres de requête

Paramètre	Description
user_id	L’ID de l’utilisateur à supprimer