Exemplo File Upload Using Multipart Form Data

Upload-Multipart-Form-Data.md

segue o exemplo de uma forma alternativa.

/**
* @OA\Post(
* tags={"Files"},
* description="Envia os arquivos especificados para o servidor.",
* path="/files/upload",
* security={{"bearerAuth":{}}},
* @OA\RequestBody(
* @OA\MediaType(
* mediaType="multipart/form-data",
* @OA\Schema(
* type="object",
* @OA\Property(
* description="file to upload",
* property="files[]",
* type="array",
* @OA\Items(
* type="string",
* format="binary",
* ),
* )
* )
* )
* ),
* @OA\Response(
* response=200,
* description="Successful operation",
* ),
* @OA\Response(
* response=401,
* description="Unauthenticated",
* ),
* @OA\Response(
* response=403,
* description="Forbidden"
* )
* )
* @param \Illuminate\Http\Request $request
* @return \Symfony\Component\HttpFoundation\BinaryFileResponse
*/

     * @OA\Post(
     *     path="/admin/resources/create",
     *     tags={"Resources"},
     *     summary="Create Resources",
     *     description="Upload the specified files to the server.",
     *     operationId="adminResourcesCreate",
     *     security={
     *        {"sanctum": {}},
     *     },
     *     @OA\RequestBody(
     *        @OA\MediaType(
     *            mediaType="multipart/form-data",
     *            @OA\Schema(
     *                type="object",
     *                @OA\Property(
     *                    property="title",
     *                    type="string",
     *                    title="Title",
     *                    description="Title",
     *                    example="Photo"
     *                ),
     *                @OA\Property(
     *                     property="description",
     *                     type="string",
     *                     title="Description",
     *                     description="Description",
     *                     example="Name file photo"
     *                ),
     *                @OA\Property(
     *                   description="file to upload",
     *                   property="file",
     *                   type="string",
     *                   format="binary",
     *                )
     *            )
     *        )
     *     ),
     * @OA\Response(
     * response=200,
     * description="Successful operation",
     * ),
     * @OA\Response(
     * response=401,
     * description="Unauthenticated",
     * ),
     * @OA\Response(
     * response=403,
     * description="Forbidden"
     * )
     * )
     * @param \Illuminate\Http\Request $request
     * @return \Symfony\Component\HttpFoundation\BinaryFileResponse
     */