Web API: Decide on presentation of uploaded files

[tadhg-ohiggins]

My current approach to this is:

• In list views, show JSON about the file (metadata), but not the file content itself, because that would be rather unwieldy.
• If the file is requested individually, return the contents of the file instead of the metadata.

One assumption here is that the file contents are the only real information the user will want, once they have its id. This may not be valid.

Options include:

• Leave it as is.
• Always return the full metadata as JSON, and include the full contents in the contents field.
• Add a new endpoint to retrieve individual file metadata.
• Change the file storage approach so that the metadata includes only a handle, and not the contents. This will require an endpoint for accessing the file contents. (See Web API: Decide on & implement file storage for uploads #302 ).