Swagger PHP & OA3 - отправить простую форму данных - PullRequest
0 голосов
/ 06 мая 2020

Я использую Laravel + Swagger + OpenAPI3 для создания API.

Я хочу просто использовать службу входа classi c, на данный момент у меня есть:

/**
 * Get a JWT via given credentials.
 *
 * @OA\Post(
 *     path="/login/login",
 *     tags={"Auth"},
 *     summary="Post login credentials",
 *     @OA\RequestBody(
 *          description= "Provide auth credentials",
 *          required=true,
 *          @OA\JsonContent(
 *              type="object",
 *              @OA\Property(property="email", type="string"),
 *              @OA\Property(property="password", type="string")
 *          )
 *     ),
 *     @OA\Response(
 *         response=200,
 *         description="get token",
 *      ),
 *    )
 *
 * @return \Illuminate\Http\JsonResponse
 */
public function login()
{
    // .....

Это нормально, но как я могу использовать здесь formData? Глядя на do c: https://swagger.io/docs/specification/describing-request-body/, я вижу, что они используют кодировку URL-адреса формы, но как я могу перевести это в аннотации PHP?

...