OpenApi 3.0 : POST /oauth/token

[piwel]

Hi,

Thanks for your work !

I just want to share one function for OpenApi 3.0, if it could help someone to have a model to build on…

/**
 * @OAS\Post(
 *      path="/oauth/token",
 *      summary="Requests a refresh token",
 *      tags={"OAuth"},
 *      operationId="refreshToken",
 *      @OAS\RequestBody(
 *          description="Request parameters",
 *          required=true,
 *          @OAS\MediaType(
 *              mediaType="application/json",
 *              @OAS\Schema(
 *                  type="object",
 *                  required={"grant_type", "client_id", "client_secret", "scope"},
 *                  @OAS\Property(
 *                      property="grant_type",
 *                      description="refresh_token or password",
 *                      enum={"refresh_token","password"},
 *                      default="password",
 *                      example="password",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *                  @OAS\Property(
 *                      property="client_id",
 *                      description="OAuth Client ID",
 *                      example="1",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *                  @OAS\Property(
 *                      property="client_secret",
 *                      description="OAuth Client Secret",
 *                      example="...",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *                  @OAS\Property(
 *                      property="scope",
 *                      description="What scopes are requested, for all, use '*'",
 *                      example="*",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *                  @OAS\Property(
 *                      property="refresh_token",
 *                      description="Refresh_token from the authorization response",
 *                      example="",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *                  @OAS\Property(
 *                      property="username",
 *                      description="Username for login",
 *                      example="",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *                  @OAS\Property(
 *                      property="password",
 *                      description="Password for the user",
 *                      example="",
 *                      @OAS\Schema(
 *                          type="string"
 *                      )
 *                  ),
 *              )
 *          )
 *      ),
 *      @OAS\Response(
 *          response=200,
 *          description="successful operation",
 *          @OAS\MediaType(
 *              mediaType="application/json",
 *          )
 *      )
 * )
 */