add chunked uploads to the postman api description

[gael-connan-cybex]

These examples allow uploading chunks from Postman to the Transmorpher server.

The following code proved useful in debugging this. Some vendor object properties may have to be set to public for this to work.
The main learning was that the filenames of chunks need to be identical when using a tool like Postman.

UploadSlotController
` public function receiveFile(UploadRequest $request, UploadSlot $uploadSlot): JsonResponse|UploadedFile
{
# DEBUG
$uploadSlotIdentifier = $uploadSlot->token;
$requestArray = $request->toArray();
$chunkNumber = $requestArray['dzchunkindex'] ?? $requestArray['chunkNumber'] ?? 'wtf';
Storage::disk()->putFileAs('', $request->file('file'), sprintf('uploadedChunk_%s_%s', $uploadSlotIdentifier, $chunkNumber));
######

    $receiver = new FileReceiver($request->file('file'), $request, HandlerFactory::classFromRequest($request));

    // Check if the chunk is successfully uploaded.
    if ($receiver->isUploaded() === false) {
        throw new UploadMissingFileException();
    }

    $save = $receiver->receive();

    // Check if the full upload has finished and if so, save the file.
    $isFinished = $save->isFinished();

    # DEBUG
    $date                                          = date('YmdHisu');
    $debugArray['requestFields']                   = $requestArray;
    $debugArray['classes']['save']                 = $save::class;
    $debugArray['classes']['handler']              = $save->handler()::class;
    $debugArray['state']['isFinished']             = $isFinished;
    $debugArray['state']['isValid']                = $save->isValid();
    $debugArray['state']['file->isValid']          = $save->file->isValid();
    $debugArray['state']['file->error']            = $save->file->error;
    $debugArray['state']['handler()->isLastChunk()'] = $save->handler()->isLastChunk();
    $debugArray['state']['handler()->foundChunks'] = $save->foundChunks ?? '(doesnt exist)';
    Storage::disk()->put(sprintf('uploadedChunk_%s_%s_data', $uploadSlotIdentifier, $chunkNumber), json_encode($debugArray, JSON_PRETTY_PRINT));
    ######

    if ($isFinished) {
        return $this->saveFile($save->getFile(), $uploadSlot, $uploadSlot->media_type);
    }

    // Full file is not yet uploaded, send the current progress.
    return response()->json([
        "done" => $save->handler()->getPercentageDone(),
    ]);
}`

` protected function saveFile(UploadedFile $uploadedFile, UploadSlot $uploadSlot, MediaType $type): JsonResponse
{
# DEBUG
Storage::disk()->putFileAs('', $uploadedFile, 'uploadedFile.mp4');
#####

...

`

[mszulik]

Tested locally with a file chunked by the Transmorpher Client backend.

Nice and easy addition to the postman file!

[gael-connan-cybex]

tested with newest postman v11.28.0. works without auth for upload.