sec-conference-server

Forked from festapp-server

Getting started

• Install MongoDB and Redis.
• Install dependencies: npm install
• When developing locally, import mock data: npm run import-data
• Run the server: npm start

Configuration

The server is configurable via environment variables:

• PORT: the port the server listens on, default 8080
• MONGOLAB_URI: the MongoDB connection URL, default mongodb://localhost/festapp-dev
• REDIS_URL: the Redis connection URL, default redis://localhost:6379
• ADMIN_PASSWORD: the password for the admin panel, default admin. The username is always admin.

For example, if you have MongoDB and Redis running locally in Docker, and your Docker host IP is 192.168.59.103, you can run your server like so:

MONGOLAB_URI=mongodb://192.168.59.103:27017/festapp-dev REDIS_URL=redis://192.168.59.103:6379 npm start

Admin panel

Admin panel for editing artist, event and other info in the database is available at /admin.

API Documentation

Get artists

GET /api/v1/artists

Response

[
  {
    "picture": "public/BadFinance.jpg",
    "quote": "”Having fun! Everyone altogether, let's rock!”",
    "content": "<p>\r\nBAD finance was formed in the early 2011 by three guys, Sakari, Antti and Jari, all working at Futurice Tampere. The band started reheasing at Jari's student dorm in Hervanta but after Futurice office moved into bigger premises the boys got their own band room.</p>\r\n",
    "featured": false,
    "status": "show",
    "founded": 2012,
    "genre": ["Love Metal"],
    "highlights": ["Bad Finance rocked the place at Futurice Christmas Party 2012."],
    "youtube": "https://www.youtube.com/watch?v=xRKzk0tKchE",
    "spotify": "",
    "contact_info": "Generic contact info, ie. email and phone number",
    "press_image": "public/BadFinance.jpg",
    "credits": "Photo: Futurice Oy",
    "place": 0,
    "_id": "53486eaaead3150200ca7919",
    "albums": ["First Album (2012)", "Second Album (2013)", "Third Album (2014)"],
    "members": ["Mike Arvela", "Sakari Hyöty", "Antti Mattila"],
    "name": "Bad Finance"
  }
]

Get Info

GET /api/v1/info

Response

[
  {
    "title": "Frequently Asked Questions",
    "image": "",
    "content": "<p><strong>First question</strong><br><br>A comprehensive response<br><br>Second question<br>A comprehensive response<br><br><br></p>\r\n",
    "place": 7,
    "_id": "53486eaaead3150200ca791a"
  }
]

Get news

GET /api/v1/news

Response

[
  {
    "title": "An example news item number one!",
    "image": "",
    "teaser_text": "This is a teaser text for the news article.",
    "content": "<p>This is the content of the article, HTML formatted to your liking.</p><br><br>\r\n",
    "time": "1970-01-17T08:03:16.129Z",
    "status": "show",
    "_id": "53486eaaead3150200ca791d"
  }
]

Get locations

GET /api/v1/locations or GET /api/v1/locations?type=RESTAURANT

type can STAGE or RESTAURANT

Response

[
  {
    "x": 100,
    "y": 100,
    "width": 100,
    "height": 100,
    "type": "STAGE",
    "_id": "53486eaaead3150200ca791e",
    "name": "Niitty",
    "description": "This is a stage"
  },
  {
    "x": 300,
    "y": 300,
    "width": 100,
    "height": 100,
    "type": "STAGE",
    "_id": "53486eaaead3150200ca791f",
    "name": "Ranta",
    "description": "This is a stage"
  }
]

Get festival

GET /api/v1/festival

Response

[
  {
    "name": "Foo",
    "organizer": "Bar",
    "start_date": "2014-04-17T04:07:26.787Z",
    "end_date": "2014-04-17T04:07:26.787Z",
    "sponsors": [
      "Futurice"
    ],
    "city": "Turku",
    "country": "Finland",
    "coordinates": {
      "lat": 51.503363,
      "lon": -0.1276250
    }
  }
]

Get events

GET /api/v1/events

Response

[
  {
    "_id": "53486eaaead3150200ca791e",
    "title": "Foo",
    "start_time": "2014-04-12T10:00:00.000Z",
    "end_time": "2014-04-12T12:00:00.000Z",
    "day": "Friday",
    "location": "This is the room where the event will happen",
    "description": "Long description.",
    "bar_camp": true,
    "key_talk": false,
    "artists": "Speaker name",
    "speaker_role": "CEO at Futurice Oy",
    "speaker_image_url": "Link to a square picture of the speaker",
    "twitter_handle": "@bobmarley",
    "linkedin_url": "https://linkedin.com/link/to/the/profile",
    "artists_2": "Second speaker name",
    "speaker_role_2": "CTO at Futurice Oy",
    "speaker_image_url_2": "Link to a square picture of the speaker",
    "twitter_handle_2": "@stevemarley",
    "linkedin_url_2": "https://linkedin.com/link/to/the/profile",
    "artists_3": "Third speaker name",
    "speaker_role_3": "CIO at Futurice Oy",
    "speaker_image_url_3": "Link to a square picture of the speaker",
    "twitter_handle_3": "@jerrymarley",
    "linkedin_url_3": "https://linkedin.com/link/to/the/profile",
    "image_url": "Link to a picture for this event, preferable resolution 1000x500 ",
    "starred_count": 2
  }
]

Starring events

POST /api/v1/events/:event_id/star

user_id parameter must be set in the POST body. user_id is used to uniquely identify users and one user can star one event only once. event_id is the database id of event.

Service integrations

List of integrated services

Getting localised data

Append lang=<lang> to the request, f.ex. /api/v1/artists?lang=fi

Localisation API

• GET /api/v1/localisation/:key (key is of format <fieldname>-<value>-<fieldtype>-<lang>)
• POST /api/v1/localisation/ (Accepts JSON in the form { 'key' : <key>, 'val' : <value>})