[Feature] @bodyParamsFile, to generate Body Parameters documentation from json file

[ajcastro]

Allow to generate Body Parameters documentation from a json file. Example:

/**
 * Store user
 *
 * @bodyParamsFile requests/users.store.json
 * 
 * @responseFile responses/users.store.json
 */

I would like to share my workflow.

1. I have helpers createJsonRequestFile() and createJsonResponseFile() that will write my json files in storage/requests and storage/responses folders. Example:

   public function test_users_store()
   {
   $response = $this->postJson(route('users.store'), $data = []);
   
   $response
   ->createJsonRequestFile()
   ->createJsonResponseFile()
   ->assertCreated();
   }

2. Then I run phpunit and apidoc:generate to generate my api docs:

   phpunit && php artisan apidoc:generate

As you can see I create my json data from unit tests and currently we have @responseFile for responses that's why I would also like to suggest feature like @bodyParamsFile for body params.

Also, maybe we can also do this for @queryParamsFile and @urlParamsFile.

[Chris-Pratt-Clystnet]

I have just run into this myself as I have a request that has a large number of body params.