clubsandsocs-api

Description

Allows you to get information about societies and clubs from university websites using the Assure Memberships Platform for use in other applications.

Supported Sites

DCU Clubs & Socs
- Site Code: dcuclubsandsocs.ie
MU Clubs & Societies
- Site Code: mulife.ie
SETU Waterford Sports Clubs & Societies
- Site Code: waterford.sportsclubsandsocieties.setu.ie
UL Clubs & Societies
- Site Code: ulwolves.ie
ATU Sligo Clubs & Socs
- Site Code: sligo.atusulife.ie
ATU Donegal Clubs & Socs
- Site Code: donegal.atusulife.ie

Supported Types

society
club

Running the Project

With Docker

Clone the repository
Run docker compose up to start the API server

Without Docker

Clone the repository
Run pip install -r requirements.txt to install the required packages
Run uvicorn api.app:app --host=0.0.0.0 --port=4000 --no-access-log to start the API server

Usage

The API has the following endpoints:

/<site>/<type> - Get all clubs/societies for a university
/<site>/<type>/<id>/activities - Get all weekly activities for a club/society
/<site>/<type>/<id>/events - Get all upcoming events for a club/society
/<site>/<type>/<id>/committee - Get the committee information for a club/society
/<site>/<type>/<id>/gallery - Get the gallery photos for a club/society
/<site>/<type>/<id> - Get info for a club/society

API Usage Examples

/ulwolves.ie/society - Get all societies in the University of Limerick
/mulife.ie/club/table-tennis/activities - Get all weekly activities for the Table Tennis Club in Maynooth University
/dcuclubsandsocs.ie/society/redbrick/events - Get all upcoming events for the Redbrick Society in DCU
/mulife.ie/society/esn/committee - Get committee information for the Erasmus Student Network Society in Maynooth University
/dcuclubsandsocs.ie/society/media-production/gallery - Get gallery photos for the Media Production Society in DCU
/ulwolves.ie/society/computer - Get info on the Computer Society of the University of Limerick