Nutzer

Das Nutzerobjekt stellt Mitglieder dar, die im Workspace angelegt wurden. Allen Nutzern wird eine rank zugewiesen, z. B. owner, admin oder normal.

Das Nutzerobjekt

{
  "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"
    }
  }
}

Felder

Feld	Typ	Beschreibung
Kennung	`string`	Der eindeutige Bezeichner des Nutzers.
createdAt	`ISODate`	Das Datum, an dem der Nutzer angelegt wurde.
updatedAt	`ISODate`	Das Datum, an dem der Nutzer zuletzt aktualisiert wurde.
activeAt	`ISODate`	Das Datum, an dem der Nutzer zuletzt aktiv war.
firstName	`string`	Der Vorname des Nutzers.
lastName	`string`	Der Nachname des Nutzers.
E-Mail	`string`	Die E-Mail-Adresse des Nutzers.
Rang	`number`	Der Rang des Nutzers.
stats.likes	`number`	Die Anzahl der Likes, die der Nutzer vergeben hat.
stats.ideas	`number`	Die Anzahl der Ideen, die der Nutzer erstellt hat.
stats.missions	`number`	Die Anzahl der Missionen, die der Nutzer erstellt hat.
stats.assignments	`number`	Die Anzahl der Ideen, denen der Nutzer zugewiesen ist.
Profilbild	Medien	Der Avatar des Nutzers.

Rang	Beschreibung
1000	Gast
2000	Standard
3000	Administrator
5000	Eigentümer

Nutzer auflisten

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();

Der obige Befehl gibt JSON in folgender Struktur zurück:

[
  {},
  {}
]

Dieser Endpunkt listet Nutzer auf.

HTTP-Anfrage

GET /v1/users

Nutzer abrufen

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();

Der obige Befehl gibt JSON in folgender Struktur zurück:

{}

Dieser Endpunkt ruft einen bestimmten Nutzer ab.

HTTP-Anfrage

GET /v1/users/:user_id

Abfrageparameter

Parameter	Beschreibung
user_id	Die ID des abzurufenden Nutzers

Nutzer erstellen

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();

Der obige Befehl gibt JSON in folgender Struktur zurück:

{}

Dieser Endpunkt erstellt einen neuen Nutzer.

HTTP-Anfrage

POST /v1/users

Nutzer aktualisieren

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();

Der obige Befehl gibt JSON in folgender Struktur zurück:

{}

Dieser Endpunkt aktualisiert einen bestimmten Nutzer

HTTP-Anfrage

PUT /v1/users/:user_id

Abfrageparameter

Parameter	Beschreibung
user_id	Die ID des zu aktualisierenden Nutzers

Nutzer löschen

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>",
  }
});

Dieser Endpunkt löscht einen bestimmten Nutzer

HTTP-Anfrage

DELETE /v1/users/:user_id

Abfrageparameter

Parameter	Beschreibung
user_id	Die ID des zu löschenden Nutzers