Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
app
 
 
bin
 
 
 
 
db
 
 
lib
 
 
log
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

FK-enrolment Analytics Code Climate Coverage Status Build Status

FK-enrolment werd ontwikkeld door Zeus WPI voor het FaculteitenKonvent Gent. Alle code is eigendom van hun respectievelijke eigenaars, bij vragen: contacteer fk-enrolment@zeus.ugent.be.

API-documentatie

FK-kringen kunnen toegang krijgen tot een REST API langswaar ze alle informatie over hun leden kunnen opvragen en wijzigen. Elke methode van de API vereist de aanwezigheid van een API-sleutel, deze is kring-specifiek en kan verkregen worden via het controle-paneel van de applicatie.

De voornaamste methodes worden hieronder beschreven:

  • GET /api/v2/members.json?key=x

    Een lijst van alle geregistreerde leden en hun geassocieerde kaart. Elk element van de array bevat een hash met alle attributen, waaronder ook een ID die in andere methods gebruikt kan worden.

    Aan deze methode kunnen ook enkele fiters worden doorgegeven als URL-parameter om zo leden op te zoeken. Beschikbare filters:

    • card (number): FK-kaart nummer
    • first_name (string): Deel van de voornaam
    • last_name (string): Deel van de familienaam
    • email (string): E-mailadres
    • ugent_nr (string): UGent nummer
  • GET /api/v2/members/[member_id].json?key=x

    Haal de informatie van 1 lid op.

  • POST /api/v2/members.json?key=x

    Voeg een nieuw lid toe. Als antwoord wordt alle opgeslagen informatie over het lid gegeven, waaronder ook het toegekende id. POST-parameters kunnen zowel op de klassieke manier of als een JSON-object (met correcte headers) verstuurd worden. Verplichte parameters zijn:

    • first_name (string)
    • last_name (string)
    • ugent_nr (string)
    • email (string)
    • sex (m of f, enkel verplicht bij ISIC)
    • date_of_birth (date, enkel verplicht bij ISIC en Citylife)
    • photo_url (string, enkel verplicht bij ISIC en Citylife)
    • home_street (string, enkel verplicht bij ISIC)
    • home_postal_code (string, enkel verplicht bij ISIC)
    • home_city (string, enkel verplicht bij ISIC)

    Andere optionele velden zijn: phone (string), studenthome_address (string)

    Kringen die beide kaarttypes toelaten en de kassa in de backend (https://registratie.fkgent.be/backend) gebruiken (dus niet via onderstaande methode) moeten card_type_preference meegeven (mogelijke waarden: isic of fk). Dit veld geeft aan welke kaartttype toegekend zal worden aan de kassa.

    Volgende velden kunnen doorgegeven worden bij een ISIC-registratie: isic_newsletter (boolean), isic_mail_card (boolean)

  • POST /api/v2/members/[id]/card.json?key=x

    Stel de kaartgegevens in van het lid [id]. Parameters zijn

    • Voor FK-kaarten:
      • number (int): toegekende FK-kaart nummer
      • status (paid of unpaid): betalingsstatus
    • Voor ISIC-kaarten:
      • status (paid of unpaid): betalingsstatus

    Als beide kaarttypes toegelaten zijn, gebruik dan card_type (isic of fk) om het gewenste kaarttype door te geven.

  • GET /api/v2/club.json?key=x

    Geeft informatie terug over de kring die deze API-sleutel identificeert, bevat ook enkele configuraties van de kring zoals ISIC-voorkeuren.

About

Enrolment system for new members of FK-clubs at Ghent University.

Topics

Resources

License

Packages

No packages published
You can’t perform that action at this time.