"As a Reader, I want to get a list of media files embedded in a page, so that I can view, read or listen to them. "
GET /page/{title}/links/media
Returns medialinks for the page.
Notable request headers: none
Request body: None
Status:
200 - OK
404 – there has never been such a page
Body: JSON
Object with these properties:
- files: array of objects representing files embedded in the page; each object has the following properties:
- title: title of the file
- latest: latest file revision, with the following properties:
- timestamp: last modified timestamp, YYYY-MM-DDTHH:MM:SSZ
- user: user object for the uploader with the following properties
- id: numeric ID or null
- name: registered user name or other identifier
- preferred: information on the preferred representation of the file for representation in a document, with these elements
- mediatype: media type for the preferred representation of the file
- size: size of the preferred representation of the file in bytes
- width: width of the preferred representation of the file in pixels if applicable (image, video, ...?)
- height: height of the preferred representation of the file in pixels if applicable (image, video, ...?)
- duration: temporal duration of the the preferred representation of the file in seconds if applicable (video, audio, ...?)
- url: full URL of the binary version of the preferred representation of the file (the image/audio/video/document itself)
- file_description_url: URL for the HTML file description page for this file, to get license info and other metadata