Response `schema` not specified in YAML files

[cnjsstong]

In the Swagger YAML files, response schema specs are not given. For example, for /account_name:

bitshares-explorer-api/swagger/paths_explorer.yaml

Lines 33 to 51 in 9444323

	"/account_name":
	get:
	description: Get account name by ID
	operationId: api.explorer.get_account_name
	parameters:
	- in: query
	name: account_id
	default: 1.2.0
	type: string
	required: true
	description: Account ID (1.2.X)
	responses:
	'200':
	description: 1 account name
	'500':
	description: Error processing parameters
	tags:
	- api
	- account

In responses, it gives only description for each status code. The schema spec (https://swagger.io/docs/specification/2-0/describing-responses/) is missing.

This may not be a big issue in some use cases. However, we will not be able to use the API with some Swagger clients who rely on the schema to unmarshal JSON (like Bravado). This makes it harder for non-technical data analysis people to retrieve and make use of the API.

[oxarbitrage]

Hi there @cnjsstong .

I think your request makes sense if we can create an automated way to get the schema from the response and insert it in the yaml.

Problem is we have so many calls and some of them have big responses like get_full_accounts that it will be a pain to make manually. Even more, as the api responses changes from the backend node we will have to update the schema.

I am not sure what will be the best way to do it, this can maybe help:
https://stackoverflow.com/questions/40908214/convert-json-to-json-schema-draft-4-compatible-with-swagger-2-0