How to add accept application/json header for swagger-php OpenApi

Question

I'm use L5-Swagger 5.7.* package (wrapper of Swagger-php) and tried describe Laravel REST API. So, my code like this:

/**
 * @OA\Post(path="/subscribers",
 *     @OA\RequestBody(
 *         @OA\MediaType(
 *            mediaType="application/json",
 *            @OA\Schema(
 *               type="object",
 *               @OA\Property(property="email", type="string")
 *            )
 *        )
 *    ),
 *   @OA\Response(response=201,description="Successful created"),
 *   @OA\Response(response=422, description="Error: Unprocessable Entity")
 * )
 */
public function publicStore(SaveSubscriber $request)
{
    $subscriber = Subscriber::create($request->all());
    return new SubscriberResource($subscriber);
}

But when I try send request via swagger panel I get code:

curl -X POST "https://examile.com/api/subscribers" -H "accept: */*" -H "Content-Type: application/json" -H "X-CSRF-TOKEN: " -d "{\"email\":\"bademail\"}"

As you can see, accept is not application/json and Laravel doesn't identify this as an AJAX request. So, when I send wrong data and expect to get 422 with errors in real I get 200 code with errors in "session". Request (XHR) through the swagger panel is also processed incorrectly, CURL code just for clarity.

Also, I found that in the previous version was used something like:

* @SWG\Post(
*     ...
*     consumes={"multipart/form-data"},
*     produces={"text/plain, application/json"},
*     ...)

But now it's already out of date.

So, how get 422 code without redirect if validation fails? Or maybe add 'XMLHttpRequest' header? What is the best thing to do here?

if you want laravel to identify it as a json request you need to specify that you're accepting json above anything else i.e. accept: application/json, */*. From the server's perspective there's no such thing as "an AJAX request" . There's nothing fundamentally special about requests that JavaScript makes. JQuery will add an X-Requested-With: XMLHttpRequest header to give a hint to the server that it's AJAX but other libraries don't do this because there shouldn't be a reason to. — apokryfos
– apokryfos, Commented Nov 6, 2018 at 8:38
My question is how to make the Swagger panel send a request to the Laravel so that it returns JSON without redirect. — Nikolay Votintsev
– Nikolay Votintsev, Commented Nov 6, 2018 at 8:55
Check swagger.io/docs/specification/describing-responses there should be a way to specify that your response is json so that should make the client try to accept that response type — apokryfos
– apokryfos, Commented Nov 6, 2018 at 9:54
@TravisBritz Consumes and Produces fields was removed from OpenAPI specification — Nikolay Votintsev
– Nikolay Votintsev, Commented Nov 6, 2018 at 10:10

Bob Fanger · Accepted Answer · 2018-11-25 16:36:34Z

15

The response(s) didn't specify a mimetype.

 @OA\Response(response=201, description="Successful created"),

If you specify a json response, swagger-ui will send an Accept: application/json header.

PS. Because json is so common swagger-php has a @OA\JsonContent shorthand, this works for the response:

@OA\Response(response=201, description="Successful created", @OA\JsonContent()),

and the requestbody:

@OA\RequestBody(
  @OA\JsonContent(
    type="object",
    @OA\Property(property="email", type="string")
  )
),

answered Nov 25, 2018 at 16:36

Bob Fanger

30k7 gold badges68 silver badges83 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Amin Nazemi · Accepted Answer · 2022-03-30 08:11:51Z

-1

you can use this, i use Request class, on the file Request

use Illuminate\Contracts\Validation\Validator;
use Illuminate\Http\Exceptions\HttpResponseException;
    public function rules()
    {
    return [
        'currentPassword' => 'required',
        'newPassword' => 'required|same:confirmPassword',
        'confirmPassword' => 'required'
    ];
    }
    protected function failedValidation(Validator $validator)
    {
        throw new HttpResponseException(response()->json([
            'errors' => $validator->errors(),
            'status' => true
        ], 422));
    }

answered Mar 30, 2022 at 8:11

Amin Nazemi

194 bronze badges

Collectives™ on Stack Overflow

How to add accept application/json header for swagger-php OpenApi

2 Answers 2

Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related