Active Users of an App
Eduplaces differentiates between users and people. Which people are available are configured explicitly by the school, whereas users are defined to have access to the app, i.e. they can perform single-sign on with the app.
You can use the users
endpoints to update your user’s properties.
Eduplaces API
GET /schools/:id/users
Path | Authentication | Required Scope |
---|---|---|
/idm/ep/v1/schools/:id/users | Access Token in the apps context (Client Credentials) | urn:eduplaces:idm:v1:users:read |
Provides a list of users of a specific school.
HTTP/1.1 200
Content-Type: application/json
[
{
"id": "1d020d46-57c8-4be5-9423-b10e3e6f85e7",
"name": {
"firstFull": "Maximilian",
"firstCall": "Max",
"last": "Mustermann"
},
"status": "ACTIVE",
"role": "STUDENT",
"groups": [
{
"id": "2cf2f091-c545-473d-99c7-7a854243d0d3",
"name": "Klasse 10a",
"status": "ACTIVE"
}
]
}
]
GET /users/:id
Path | Authentication | Required Scope |
---|---|---|
/idm/ep/v1/users/:id | Access Token in the apps context (Client Credentials) | urn:eduplaces:idm:v1:users:read |
Gets a specific user by its ID.
HTTP/1.1 200
Content-Type: application/json
{
"id": "1d020d46-57c8-4be5-9423-b10e3e6f85e7",
"name": {
"firstFull": "Maximilian",
"firstCall": "Max",
"last": "Mustermann"
},
"status": "ACTIVE",
"role": "STUDENT",
"groups": [
{
"id": "2cf2f091-c545-473d-99c7-7a854243d0d3",
"name": "Klasse 10a",
"status": "ACTIVE"
}
]
}
This endpoint provides no information about the user’s access to your app.
It returns all users that signed in to your app at least once without checking if they still have access.
You should assume that a user can return to your app at any time, as long as you do not receive a 404 Not Found
status for that user.
Receiving “404 Not Found: User not found”?
This means that the user does not exist or was deleted forever.
If you have any data related to this user, you should remove it from your app as the user is no longer retrievable.
In contrast, if the field status
is set to SOFT_DELETED
, the user was deleted but not irretrievable.
In this case you should not remove any data related to this user from your app, as the user might be restored and return to your app later.