Retrieve Talks via ID

Endpoint to retrieve information about talks

All the responses conform to the HAL specification.

GET /talks/(string: id)

Retrieve talk by ID

Example request:

GET /api/talks/fa67d13a-f17d-471d-b8cc-33b3d7759956
Host: talks.ox.ac.uk
Accept: application/json

Example response:

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

{
    "_links": {
        "self": {
            "href": "/api/talks/fa67d13a-f17d-471d-b8cc-33b3d7759956"
        },
        "talks_page": {
            "href": "/talks/id/fa67d13a-f17d-471d-b8cc-33b3d7759956/"
        }

    },
    "title": "What can babies with Down syndrome possibly tell us about Alzheimer's dementia in adults?",
    "start": "2015-01-29T18:00:00Z",
    "end": "2015-01-29T19:00:00Z",
    "formatted_date": "29 January 2015, 18:00",
    "formatted_time": "18:00",
    "description": "It may seem paradoxical to focus on babies ...",
    "_embedded":
    {
        "speakers": [ ],
        "venue": {
            "_links": {
                "self": {
                    "href": "//api.m.ox.ac.uk/places/oxpoints:50009121"
                }
            },
            "name": "Mary Gray Allen Building",
            "map_link": "//maps.ox.ac.uk/#/places/oxpoints:50009121"

        },
        "organising_department": null,
        "topics": [
            {
                "uri": "http://id.worldcat.org/fast/806532",
                "label": "Alzheimer's disease"
            }, {
                "uri": "http://id.worldcat.org/fast/890050",
                "label": "Dementia"
            }
        ]
    }
}
Parameters:
  • id (string) – The unique slug identifier for the talk
Status Codes:
GET /talks/search

Search for events

Example request:

GET /api/events/search?from=today&topic=X HTTP/1.1
Host: talks.ox.ac.uk
Accept: application/json

Example response:

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

{
    "_links": {
        "self": {
            "href": "http://127.0.0.1:8000/api/talks/search?from=01/01/01"
        },
        "next": null,
        "prev": null
    },
    "_embedded":
        {
            "talks": [
            {
                "_links": {
                    "self": {
                        "href": "/api/talks/fa67d13a-f17d-471d-b8cc-33b3d7759956"
                    },
                    "talks_page": {
                        "href": "/talks/id/fa67d13a-f17d-471d-b8cc-33b3d7759956/"
                    }

                },
                "title": "What can babies with Down syndrome possibly tell us about Alzheimer's dementia in adults?",
                "start": "2015-01-29T18:00:00Z",
                "end": "2015-01-29T19:00:00Z",
                "formatted_date": "29 January 2015, 18:00",
                "formatted_time": "18:00",
                "description": "It may seem paradoxical to focus on babies ...",
                "_embedded":
                {
                    "speakers": [ ],
                    "venue": {
                        "_links": {
                            "self": {
                                "href": "//api.m.ox.ac.uk/places/oxpoints:50009121"
                            }
                        },
                        "name": "Mary Gray Allen Building",
                        "map_link": "//maps.ox.ac.uk/#/places/oxpoints:50009121"

                    },
                    "organising_department": null,
                    "topics": [
                        {
                            "uri": "http://id.worldcat.org/fast/806532",
                            "label": "Alzheimer's disease"
                        }, {
                            "uri": "http://id.worldcat.org/fast/890050",
                            "label": "Dementia"
                        }
                    ]
                }
            }
            ]
        }
    }
Query Parameters:
 
  • from – Date to start filtering on (mandatory). Format should be dd/mm/yy OR ‘today’ or ‘tomorrow’
  • to – Optional date to end filtering. Format should be dd/mm/yy OR ‘today’ or ‘tomorrow’
  • subvenues – If true, include all sub-locations of the specified venue within the search
  • subdepartments – If true, include all sub-organisations of the specified department within the search

The below parameters can each be repeated multiple times

Query Parameters:
 
  • topic – Topic URI
  • venue – Search for talks taking place at the location specified by the oxpoints ID
  • organising_department – Search for talks whose organising department is the organisation specified by this oxpoints ID
  • speaker – Search for talks at which the specified person is a speaker. Supply the unique slug for the person e.g. ‘james-bond’

The response can be either in XML or JSON dependent on the ‘accept’ header in the request.

Status Codes: