Update mediaservice interface

This commit is contained in:
Finn Stutzenstein 2020-12-08 10:05:00 +01:00
parent b2909e0f1c
commit 67f3312090
No known key found for this signature in database
GPG Key ID: 9042F605C6324654

View File

@ -1,16 +1,35 @@
/**
* Saves a file (encoded as base64) into this service.
* Saves a mediafile (encoded as base64) into this service.
*
* Technical:
* POST to /internal/media/upload/ with JSON payload.
* Returns 200 on success, 4xx on Errors with a message in the payload.
* POST to /internal/media/upload_mediafile/ with JSON payload.
* Returns 200 on success, 4xx on errors with a message in the payload.
*/
upload(file: string, id: Id, mimetype: string): {message: string} | void
upload_mediafile(file: string, id: Id, mimetype: string): {message: string} | void
/**
* Retrieves a mediafile given by the meeting and the path of the file.
* Saves a resource (encoded as base64) into this service.
*
* Technical:
* GET to /system/media/get/<meeting_id>/<path>
* POST to /internal/media/upload_resource/ with JSON payload.
* Returns 200 on success, 4xx on errors with a message in the payload.
*/
get(meeting_id: Id, path: string): Blob
upload_resource(file: string, id: Id, mimetype: string): {message: string} | void
/**
* Retrieves a mediafile given by it's id.
*
* Technical:
* GET to /system/media/get/<mediafile_id>
* Returns 200 on success and 404, if the resource does not exist
*/
get(mediafile_id: Id): Blob
/**
* Retrieves a resource given by it's id.
*
* Technical:
* GET to /system/media/get_resource/<resource_id>
* Returns 200 on success and 404, if the resource does not exist
*/
get(resource_id: Id): Blob