SpedySpedy Docs

Nutzer

Nutzer auflisten und Aktivitäten innerhalb deiner Organisation einsehen.

Nutzer repräsentieren die Personen in deiner Organisation. Du kannst Mitglieder auflisten, ihre Profile einsehen und ihre Aktivitäten überprüfen.

Nutzer auflisten

GET /api/v1/users

Berechtigung erforderlich: members:view

Gibt alle Nutzer der Organisation zurück.

Beispiel-Response

[
  {
    "id": "usr_abc123",
    "email": "[email protected]",
    "name": "Alex Smith",
    "role": "Admin",
    "createdAt": "2025-01-15T10:00:00Z"
  },
  {
    "id": "usr_def456",
    "email": "[email protected]",
    "name": "Jamie Lee",
    "role": "TeamMember",
    "createdAt": "2025-02-01T09:00:00Z"
  }
]

Nutzer abrufen

GET /api/v1/users/{userId}

Berechtigung erforderlich: members:view

Gibt Details zu einem bestimmten Nutzer zurück.

Aktivitätsübersicht abrufen

GET /api/v1/users/{userId}/activity-summary

Berechtigung erforderlich: members:view

Gibt eine Aktivitätsübersicht für einen Nutzer zurück, einschließlich Event-Zählern und am häufigsten besuchten Boards.

Query-Parameter

ParameterTypPflichtBeschreibung
fromstringNeinStartdatum (ISO 8601)
tostringNeinEnddatum (ISO 8601)

Beispiel-Response

{
  "userId": "usr_abc123",
  "period": {
    "from": "2025-03-01T00:00:00.000Z",
    "to": "2025-03-31T23:59:59.999Z"
  },
  "eventCounts": {
    "ticketCreated": 12,
    "commentAdded": 34,
    "statusChanged": 8
  },
  "lastActivityAt": "2025-03-20T15:30:00.000Z",
  "mostViewedBoards": [
    { "boardId": "brd_abc123", "name": "Website Redesign", "viewCount": 45 }
  ]
}