return json instead of str

[singhpranjali]

Per discussion: #43 (review)
Changing from string response to json

[csadorf]

Thank you for the quick fix, however it missing the data models for the return types as pointed out inline.

[csadorf]

The functions are still missing the appropriate response models. I am very sorry that my previous comment was in so far easy to misunderstand.

As an example, the correct response model for the create_dataset function is DatasetCreateResponse. This can be inferred from the standard-app-api definition. In other cases it might be a bit less obvious, e.g., for the get_dataset_metadata function I would expect to simply receive a plain dict.

The standard-app-api implements the API specification and also serves as a prototype for the actual server implementation. The server expects Response types, because it is a web server. However, the SDK is to be used by application developers. They do not need to worry about the HTTP responses anymore, here we should work with Python types as appropriate. So, coming back to the original example, getDatasetMetadata function is to be used to actually obtain the dataset metadata (as a dict), not to generate a server response.

[csadorf]

Is there still a path where this function would return str?

(Same question for all other similar occurrences.)