bitshares
Response `schema` not specified in YAML files
In the Swagger YAML files, response schema specs are not given. For example, for /account_name:
https://github.com/bitshares/bitshares-explorer-api/blob/9444323252b429fc6b2d9ac2781a05d2f7004c19/swagger/paths_explorer.yaml#L33-L51
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.
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
