Retrieve Collection via ID¶
Endpoint to retrieve information about all talks collected together in a Public Collection
All the responses conform to the HAL specification.
-
GET
/collections/id/
(string: id)¶ Retrieve collection by unique slug identifier, including all talks
Example request:
GET api/collections/id/f6e6d9e6-d166-47d9-a894-35bc2f4a4580 Host: talks.ox.ac.uk Accept: application/json
Example response
HTTP/1.1 200 OK Content-Type: application/json { "_embedded": { "talks": [ { "_links": { "self": { "href": "/api/talks/52360e07-9b8b-477d-8bc7-8a25995e5ef8" }, "talks_page": { "href": "/talks/id/52360e07-9b8b-477d-8bc7-8a25995e5ef8/" } }, "description": "", "end": "2015-10-06T10:45:00Z", "formatted_date": "6 October 2015, 11:00", "formatted_time": "11:00", "location_details": "Seminar room", "location_summary": "Weatherall Institute of Molecular Medicine (WIMM), Seminar room, Headington OX3 9DS", "organiser_email": "liz.rose@imm.ox.ac.uk", "series": { "slug": "f204e37e-640e-4e1a-a3ef-dfb48c45630a", "title": "WIMM Occasional Seminars" }, "slug": "52360e07-9b8b-477d-8bc7-8a25995e5ef8", "start": "2015-10-06T10:00:00Z", "title_display": "Ameliorating \u03b2-thalassaemia by manipulating expression of the \u03b1-globin gene" } ] }, "_links": { "talks_page": { "href": "/user/lists/id/f6e6d9e6-d166-47d9-a894-35bc2f4a4580/" } }, "description": "Talks about Athena Swan", "title": "Athena Swan Talks" }
The response can be either in XML or JSON dependent on the ‘accept’ header in the request.
Status Codes: - 200 OK – Collection found
- 404 Not Found – Collection not found
- 503 Service Unavailable – Service not available
Parameters Reference¶
- id : collection 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