Skip to content
Usako edited this page Dec 8, 2015 · 4 revisions

Welcome to the EventsAPI wiki!

The EventsAPI is intended to be a means through which events can be disseminated to all applicable social media/web sites via a single interface/submission point. This saves organizers precious time and frustration having to log into multiple sites to post the same information in many various locations.


Application Description

The Events API is a one point broadcast method for disseminating event information to all social media used by UAS.

Technical Specification

The Events API is a RESTful web service that accepts JSON post requests from authenticated clients to broadcast event information to all supported social media site.

Social Media Sites Supported

  • Google Calendar
  • Meetup.com
  • Twitter

Request Types

  • createEvent
    • Creates event(s) on each social media site supported.
  • updateEvent
    • Updates event information on each social media site supported.
  • deleteEvent
    • Deletes events information on each social media site supported.
  • cancelEvent
    • Updates events to indicated cancellation on each social media site supported.

More detailed descriptions and technical specification follows for each request type.

createEvent()

HTTPS/SSL Authentication

Parameters

  • Event Title
  • Event Description
  • Event Short Description
  • Start Date Time (Format: epoch)
  • [End Date Time] (Format: epoch)
  • [array of ‘replicated events’]
    • Start Date Time (Format: epoch)
    • [End Date Time] (Format: epoch)

Return

  • Arrays of ids for event(s) created for each social media site supported.

updateEvent()

HTTPS/SSL Authentication

Parameters

  • Media Site IDs
  • [Event Title]
  • [Event Description]
  • [Event Short Description]
  • [Start Date Time] (Format: epoch)
  • [End Date Time] (Format: epoch)
  • [array of ‘replicated events’]
    • Media Site IDs
    • [Start Date Time] (Format: epoch)
    • [End Date Time] (Format: epoch)

Return

  • Array of Success or Failure for each media

deleteEvent()

HTTPS/SSL Authentication

Parameters

  • Media Site IDs
  • [array of ‘replicated events’]
    • Media Site IDs
    • [Start Date Time] (Format: epoch)
    • [End Date Time] (Format: epoch)

Return

  • Array of Success or Failure for each media

cancelEvent()

HTTPS/SSL Authentication

Parameters

  • [Cancelled Event Description]
  • [Cancelled Event Short Description]
  • Media Site IDs
  • [array of ‘replicated events’]
    • Media Site IDs
    • [Start Date Time] (Format: epoch)
    • [End Date Time] (Format: epoch)

Return

  • Array of Success or Failure for each media
Clone this wiki locally