Estoy escribiendo un documento API con la ayuda de Swagger 2.0. He generado una API donde la respuesta está en una variedad de libros que funciona bien.

 [{ "id": 1, "book_name": "The Complete Reference Java8", "author": "Herbert Schidt", "genre": "Technology" }, { "id": 2, "book_name": "C Programming", "author": "Dennis Ritchie", "genre": "Technology" }]

Pavonearse

 /fetchBooks: get: description: | Returns an array of book objects. responses: 200: description: Successful response schema: title: ArrayOfBooks type: array items: type: object properties: id: type: integer book_name: type: string author: type: string genre: type: string

Bueno, quiero enviar solo los detalles de un libro en una API en JSONObject qué tipo de esquema debo tomar, ya que probé que el objeto no funciona.

 { "id": 1, "book_name": "The Complete Reference Java8", "author": "Herbert Schidt", "genre": "Technology" }

Pavonearse

 /fetchBook: get: description: | Returns a book object parameters: - name: id in: query description: Books Id's reqrequired: true type: integer format: int responses: 200: description: Successful response schema: type: object <-- What type should I specify for JSONObject here items: type: object properties: id: type: integer book_name: type: string author: type: string genre: type: string

Como el objeto no funciona, Swagger no muestra el formato JSON .

Estado actual :

Estado esperado: