laravel post l5-swagger sample
/**
* @OA\Post (
* path="/api/sample",
* operationId="getSample",
* tags={"Sample"},
* summary="get sample",
* description="return sample",
* @OA\RequestBody(
* required=true,
* @OA\JsonContent(ref="#/components/schemas/UserRequest")
* ),
* @OA\Parameter(
* name="department",
* required=true,
* in="header",
* example=1,
* ),
* @OA\Response(
* response=200,
* description="Successful operation",
* @OA\JsonContent(ref="#/components/schemas/BasicResource")
* ),
* @OA\Response(
* response=400,
* description="Bad Request"
* ),
* @OA\Response(
* response=401,
* description="Unauthenticated",
* ),
* @OA\Response(
* response=403,
* description="Forbidden"
* )
* )
*/