Retrieve Series via ID¶
Endpoint to retrieve information about all talks in a series
All the responses conform to the HAL specification.
-
GET
/series/
(string: id)¶ Retrieve series by unique slug identifier, including all talks
Example request:
GET /api/series/d95be2ef-10bb-43d3-a46c-99dccf7151a0 Host: talks.ox.ac.uk Accept: application/json
Example response
{ "_links": { "self": { "href": "/api/series/d95be2ef-10bb-43d3-a46c-99dccf7151a0" }, "talks_page": { "href": "/talks/series/id/d95be2ef-10bb-43d3-a46c-99dccf7151a0" } }, "title": "ChemBio Hub Events", "description": "", "occurence": "", "_embedded": { "talks": [{ "_links": { "self": { "href": "/api/talks/88ba512b-8ac1-4191-a86e-340f8f3fed1d" }, "talks_page": { "href": "/talks/id/88ba512b-8ac1-4191-a86e-340f8f3fed1d/" } }, "title_display": "Current expertise and future directions in drug discovery: an Oxford-Industry conversation", "slug": "88ba512b-8ac1-4191-a86e-340f8f3fed1d", "start": "2015-07-31T09:00:00Z", "end": "2015-07-31T19:00:00Z", "formatted_date": "31 July 2015, 9:00", "formatted_time": "09:00", "description": "This event showcases top chemical biology research from labs at Oxford. ...", "location_details": "", "location_summary": null, "series": { "slug": "d95be2ef-10bb-43d3-a46c-99dccf7151a0", "title": "ChemBio Hub Events" }, "_embedded": { "speakers": [], "venue": null, "organising_department": { "address": "off South Parks Road OX1 3QU", "_links": { "self": { "href": "//api.m.ox.ac.uk/places/oxpoints:23232534" } }, "name": "Department of Biochemistry", "map_link": "//maps.ox.ac.uk/#/places/oxpoints:23232534" }, "topics": [] }, "organiser_email": "" }] } }
The response can be either in XML or JSON dependent on the ‘accept’ header in the request.
Status Codes: - 200 OK – Series found
- 404 Not Found – Series not found
- 503 Service Unavailable – Service not available
Parameters Reference¶
- id : series slug as string
- Format
f8ecded3-d2af-4585-bd3b-5cd7440795b9
- Format
- from : date string (‘yyyy-mm-dd’), optional
- Start date for the list of talks.
- Format as
yyyy-mm-dd
- to : date string (‘yyyy-mm-dd’), optional
- End date for the list of talks.
- Format
yyyy-mm-dd
- Or use
plus[n]
for the next [n] days (e.g.: plus7) - Note that the issue with the end time (assumed to be 00:00 not 23:59) has now been resolved