Events 2019-08-20T14:23:04+08:00

API – Events

Introduction

The events object includes events data of University of Macau. The earliest data tracks back to Nov 2002. The data is refreshed in at least 15 minutes.

Figure 1: Relationships between events, common and details

 

API Reference

Events Data Dictionary

FieldTypeIndexedDescriptionExample
itemIdintegerYesUnique ID for each events"itemId": 44514
lastModifieddateYesLatest modified date time for the events"lastModified": "2018-03-13T14:52:58+08:00"

Common Data Dictionary

Information of the news which is common across different language, e.g. publishDate, dateFrom and dateTo, etc.

FieldTypeIndexedDescriptionExample
publishDatedateYesThe date that the event is published, in UTC+8:00"publishDate": "2018-03-27T10:57:11+08:00"
dateFromdateYesThe start date of the event, in UTC+8:00 (inclusive)"dateFrom": "2018-03-22T00:00:00+08:00"
dateTodateYesThe end date of the event, in UTC+8:00 (inclusive)"dateTo": "2018-03-22T00:00:00+08:00"
posterUrlstringNoThe URL for download the poster, if available"posterUrl": "http://news.umac.mo/nrs/binary?id=R8NFTyXkG4tkAnlqizSJHNxVVmC7unsJ2_2FwwB4XVeeU_3D"
smartPointbooleanNoIndicator for gaining Smart Point by participating in the events.

Smart Point (SP) is an incentive scheme that encourages UM students to participate in major activities in the University

"smartPoint": "true"
timeFromdateNo
  • The start time of the event, in UTC+8:00, if available
  • Only the time string between “T” and “Z” is valid, which stands for HH:MM:SS.fff
"timeFrom": "1970-01-01T18:30:00+08:00"
timeTodateNo
  • The end time of the event, in UTC+8:00, if available
  • Only the time string between “T” and “Z” is valid, which stands for HH:MM:SS.fff
"timeTo": "1970-01-01T22:00:00+08:00"
attachmentUrlsstring[]YesThe URL for downloading the attachment file of the event, if available"attachmentUrls" : ["http://news.umac.mo/nrs/binary?id=UUnz_2Ff955vdwZCrDbEuxnf07AKXwXMr106tWNPCPD04_3D"]
recurringDaysOfWeekstringNoThe days of week that the event recurs, express in number format:

  • 1: Monday
  • 2: Tuesday
  • 3: Wednesday
  • 4: Thursday
  • 5: Friday
  • 6: Saturday
  • 7: Sunday

e.g. “1” means that the event will occur every Monday within the date range (between “dateFrom” and “dateTo”)

"recurringDaysOfWeek" : [1]

Details Data Dictionary

Information of the news details in English, Chinese or Portuguese.

FieldTypeIndexedDescriptionExample
localestringNoLanguage of the event details

  • en_US: English
  • zh_TW: Traditional Chinese
  • pt_PT: Portuguese
"locale": "en_US"
titlestringNoTitle of the news"title" : "MCM College: INNOVATION IS GREAT High Table"
contactEmailstringNoContact Email for the event"contactEmail" : "mcmofficeofthemaster@umac.mo"
contactFaxstringNoContact fax number for the event"contactFax" : "8822 2312"
contactNamestringNoContact person for the event"contactName" : "Ray Loi"
contactPhonestringNoContact Phone number for the event"contactPhone" : "8822 9976"
coorganizersstring[]NoCo-organizers of the event, if available"coorganizers" : [ "The Script Road – Macau Literary Festival"]
languagesstring[]NoLanguage of the event, if available"languages": "Cantonese"
contentstringNoDescription of the event, if available"content" : "Ms. JOYCE CHIU is invited to share her experience working as a public relations manager in the hotel industry, she will also introduce the works of public relations and the skills required. "
dateStringstringNoDescription for the event date range and recurring day of the week, if available"dateString" : "16 April, 2018 (Monday) "
organizedBysstring[]NoThe organizer of the event"organizedBys" : [ "Moon Chun Memorial College"]
remarkstringNoRemarks for the event"remark" : "Application link: nhttps://goo.gl/forms/qa2wy659rHSuN7jl2nnCompetition regulation at WeChat: https://mp.weixin.qq.com/s/5LRnkHjvHYDkbwpOel7A6w"
speakersstring[]NoName of the speak of the event, if available"speakers" : [ "Ms. Joyce CHIU"]
targetAudiencesstring[]NoTarget audiences of the event, if available"targetAudiences" : [ "MCMC members"]
timeStringstringNoDescription for the event time range, if available
venuesstring[]NoVenue(s) of the event"venues" : [ "W11-G036, MCM College Hall"]
attachmentLangUrlsstring[]NoThe URL for downloading the attachment file of the event in a specific language, if available"attachmentLangUrls" : ["http://news.umac.mo/nrs/binary?id=WUVodwm_2F6K1L9Bk9M9o6OcUGztI2oX2s90WgVkxb_2B5IwgpM63gSAZw_3D_3D"]