Я только начал работать с 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());
}
}
Куда я иду не так и как я могу это исправить?