/it.bz.noi.calendar-api

Primary LanguageC#GNU Affero General Public License v3.0AGPL-3.0

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