FileIds in endpoints

[Rello]

https://github.com/tobiasKaminsky/declarativetest/blob/main/lib/Capabilities.php#L26-L32

Hi,

what should we do with the content to be transmitted to endpoints?
I am currently looking at using it for my app.
I think it will come down to transmitting a fileId on the first version. we need a way to tell in the capabilites how the endpoint is expecting it.

Option A:
replacement variable with the GET in the URL

[
"name" => "Convert to PDF", 
"url" => "/ocs/v2.php/apps/declarativetest/convertFile/{fileId}", 
"filter" => "image/", 
"method" => "GET",
"payload" => ""
],

Option B:
replacement variable in the POST payload

[
"name" => "Convert to PDF", 
"url" => "/ocs/v2.php/apps/declarativetest/convertFile", 
"filter" => "image/", 
"method" => "POST", 
"payload" => "fileid={fileId}, otherContent=xzw"
],

what do you think?

[Rello]

we should go for OCS - so everything is post.
how to we handle the fileId?
do we always send it under the variable "fileId" or do we allow it to be flexible?

my suggestion would be:

[
'name' => 'Show data in Analytics',
'url' => '/ocs/v2.php/apps/analytics/createFromDataFile',
'filter' => 'text/csv',
'fileIdVariable' => 'fileId'
],

what do you think?
@tobiasKaminsky