Document audio extension

[kvlahromei]

As the old GeoReporter App doesn't support multimedia-content, it would be nice to point server operators to the Open311 extension to add audio-support. Is it based on CitySDK upload?

[milovanderlinden]

Caught me there! The audio extension is undocumented. At first we had a multipart/form-data upload. But then we noticed that most open311 services want a single string as media_url. So now we require an upload service that doesn't necessarily has to be part of the open311 infrastructure to give us url's. These url's are then put in media_url and media(array) which are currently parsed in different ways by our open311-api. Needs to be discussed on the open311 forum.

Until then, we will introduce variation in the type of open311 backend being used. If a backend supports media_url only, the audio-support will be hidden. And from there, we can set up different variations.

So the first step would be; hide audio on legacy endpoints.

[milovanderlinden]

Any help on making this possible would be highly appreciated. The way "media" is implemented under the hood is that it would be possible in theory to send multiple images, audio-files, pdf's, video and so on. In theory, because at the moment, the UI doesn't facilitate in this.