it.bz.noi.calendar-api
Configuration
The following environment variables are needed:
TENANT_ID=b6acf547-c352-4708-a725-ec0e662c5d11
CLIENT_ID=f275e5cc-1c0c-4b1c-8308-4d645c13c39b
USERNAME=noiappexchbutler@noi.bz.it
PASSWORD=<PASSWORD>
OPENID_AUTHORITY=https://auth.opendatahub.testingmachine.eu/auth/realms/noi/
MEETING_ROOMS=meetingroom02@noi.bz.it,meetingroom41@noi.bz.it,meetingroom14@noi.bz.it,meetingroom26@noi.bz.it
NUMBER_OF_EVENTS=3
- `TENANT_ID`
- The ID for the Azure Tenant to authenticate against Azure AD.
- `CLIENT_ID`
- The ID for the client app registered in Azure AD.
- `USERNAME`
- The username for the authentication againts Azure AD
- `PASSWORD`
- The password for the authentication againts Azure AD
- `OPENID_AUTHORITY`
- The auth endpoint for the Open ID provider (NOI Auth server in this case)
- `MEETING_ROOMS`
- The meeting rooms to retrieve can be provided with the `MEETING_ROOMS` environment variable. You can delimit the rooms by comma `,` or by semicolon `;`.
- `NUMBER_OF_EVENTS` (optional, defaults to 5)
- The number of retrieved events can be configured by setting the `NUMBER_OF_EVENTS` environment variable.
Usage
Authenticate with the NOI Authentication server.
You can use OData query functionality. The following OData query options are available: $top
, $filter
, $select
, $orderby
, $count
Examples
-
Query for the next 3 events:
<BASE_URL>?$top=3&$orderby=start
-
Query for the events of a specific meeting room:
<BASE_URL>?$filter=meetingroom eq 'meetingroom02@noi.bz.it'
-
Query for the events containing a specific subject:
<BASE_URL>?$filter=contains(subject, 'Meeting')
-
Return only subject and start date:
<BASE_URL>?$select=subject,start