Rooms

Added in version 0.9.0: This resource endpoint.

Resource description

The room resource contains the following public fields:

Field

Type

Description

id

number

The unique ID of the room object

name

multi-lingual string

The name of the room

description

multi-lingual string

The description of the room

capacity

number

How many people fit in the room

position

number

A number indicating the ordering of the room relative to other rooms, e.g. in schedule visualisations

speaker_info

multi-lingual string

Additional information for speakers.

availabilities

list

A list of objects with a start and end attribute, both datetimes. Only available if the requesting user has organiser privileges.

Endpoints

GET /api/events/{event}/rooms

Returns a list of all rooms configured for this event.

Example request:

GET /api/events/sampleconf/rooms HTTP/1.1
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 23,
      "name": "R101",
      "description": "Next to the entrance",
      "capacity": 50,
      "position": 10
    }
  ]
}
Parameters:
  • event – The slug field of the event to fetch

Query Parameters:
  • page – The page number in case of a multi-page result set, default is 1

GET /api/events/(event)/rooms/{id}

Returns information on one room, identified by its ID.

Example request:

GET /api/events/sampleconf/rooms/23 HTTP/1.1
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

 {
   "id": 23,
   "name": "R101",
   "description": "Next to the entrance",
   "capacity": 50,
   "position": 10
 }
Parameters:
  • event – The slug field of the event to fetch

  • code – The id field of the room to fetch

Status Codes: