User API

Stadium applications with Authentication mode Email & Password or Single Sign-on come with a REST API that can be used to remotely manage application users.

Setup

Calling the application User API requires a key. Generate this key in the Stadium Application Manager (SAM) under the application's User API section.

Here you can also download an Open API definition file.

Operations

The API exposes the operations below

Replace the <api-key> placeholder in the URL's below with the key you generated for your application. Replace the <application-url> placeholder with the base url of your site (e.g. server.com/myapplication)

Fetch All Users

Returns a Json object containing all users. Use a querystring parameter "email" to filter the results by email.

URL

https://<application-url>/api/users?key=<api-key>&email=@example.com

Method

GET

Example Response (application/json)

[
    {
        "id": "2e718832-3669-43f3-8eae-75f30360c17d",
        "email": "[e-mail]",
        "name": "Mike Carter",
        "username": "[e-mail]",
        "isAdministrator": true,
        "roles": [
            "User",
            "Developer"
        ],
		"data": {}
    },
    {
        "id": "d02123fd-730d-4c93-a9c9-e0ee4270e94d",
        "email": "[e-mail]",
        "name": "Loretta Pearson",
        "username": "[e-mail]",
        "isAdministrator": false,
        "roles": [
            "User",
            "Team Leader"
        ],
		"data": {}
    }
]

NOTE: The data object is used in the Single Sign-On process by Stadium and is not available to API users.

Fetch Users

Returns a Json object containing the details of a specific user The UserID is generated by Stadium and can be retrieved using the Fetch Users API call

URL

https://<application-url>/api/users/<USERID>?key=<api-key>

Method

GET

Example Response (application/json)

{
    "id": "d02123fd-730d-4c93-a9c9-e0ee4270e94d",
    "email": "[e-mail]",
    "name": "Loretta Pearson",
    "username": "[e-mail]",
    "isAdministrator": false,
    "roles": [
        "User",
        "Team Leader"
    ],
	"data": {}
}

NOTE: The data object is used in the Single Sign-On process by Stadium and is not available to API users.

Add User

Creates a new user record

URL

https://<application-url>/api/users?key=<api-key>

Method

POST

Content Type

application/json

Body (example)

{
	"email": "<EmailAddress>",
	"name": "<Name>",
	"password": "<Password>",
	"roles": ["<Role1>", "<Role2>"],
	"isAdministrator": true
}

Example Response (application/json)

{
    "userID": "efd1251c-d986-4d52-bf61-38b7b384958b"
}

Update User

Updates an existing user record

The UserID is generated by Stadium and can be retrieved using the Fetch Users API call

URL

https://<application-url>/api/users/<USERID>?key=<api-key>

Method

PUT

Content Type

application/json

Body - all fields are optional (example)

{
	"email": "<EmailAddress>",
	"name": "<Name>",
	"password": "<Password>",
	"roles": ["<Role1>", "<Role2>"],
	"isAdministrator": true
}

Delete User

Deletes an existing user

The UserID is generated by Stadium and can be retrieved using the Fetch Users API call

URL

https://<application-url>/api/users/<USERID>?key=<api-key>

Method

DELETE

Fetch Roles

Returns a Json object containing all available roles

URL

https://<application-url>/api/roles?key=<api-key>

Method

GET

Example Response (application/json)

[ "Developer", "Team Leader", "User" ]