Не удается получить данные из документа Swagger API - PullRequest
0 голосов
/ 06 июня 2019

Я только начал работать с swagger / openapi вчера вечером и пытаюсь документировать API для приложения для демонстрационного книжного магазина, но не могу получить данные из API на swagger-ui.

Вот ссылкав книжный магазин api doc api doc

Я добавил аннотации к BookController, как это

/**
 *  @OA\Schema(
 *      schema="Book",
 *      @OA\Property(property="title", type="string"),
 *      @OA\Property(property="author", type="string"),
 *      @OA\Property(property="description", type="string")
 *  )
 */
/**
 *  @OA\Schema(
 *      schema="NewBook",
 *      required={"title", "author", "description"}
 *  )
 */

class BookController extends Controller
{
    /**
     * @OA\Get(
     *     path="/books",
     *     description="Returns a books list from the app",
     *     operationId="getBooksList",
     *     summary="Gets a complete list of all books available on the app with their ratings",
     *     @OA\Response(
     *         response=200,
     *         description="book response",
     *         @OA\JsonContent(
     *             type="array",
     *             @OA\Items(ref="#/components/schemas/Book")
     *         )
     *     ),
     *     @OA\Response(
     *         response="default",
     *         description="unexpected error",
     *     )
     * )
     */
    /**
     * Display a listing of the books.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        return BookResource::collection(Book::with('ratings')->get());
    }
}

Куда я иду не так и как я могу это исправить?

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...