Closed MichaelRoeder closed 5 months ago
Somewhat adressed in https://github.com/dice-group/Ontolearn/pull/402 Yet, I guess your suggestion is more intuitive than the current state. In the next release (End of June), we will use your suggestion as it is @MichaelRoeder :)
I guess we will stick the the current Webservice API :)
User Story
At the moment, the web service provides the best result it found in the following form:
As a user of the web service, I would like to have the option to receive more details about the result. In older versions, I received a list of expressions together with their quality. It would also be great to get the expressions in a verbalized form. However, these results should be optional.
Suggested Solution
The user could add two parameters to the request:
number_of_results
defines the number of best expressions that the system retrievedverbalization
if this is set totrue
, the service should provide a verbalized form of the result (with a default value =false
)Number of Results
Request
The parameter could be simply added to the JSON object that is sent as part of the request:
If the parameter is missing, only the best result should be reported, i.e., the service should have the behavior that is already implemented.
Response
A possible extension of the existing response could be the following:
Verbalization
Request
The parameter could be simply added to the JSON object that is sent as part of the request:
Response
A possible extension of the existing response could be the following:
Both
Request
A combination of the parameters as explained above:
Response
The verbalization should be applied to all results:
Hint
The keys of the request or result should follow a common pattern. At the moment, some start with a capital letter while others don't. There is also no common pattern in the examples above. However, it might be good to try to already stick to such a pattern while extending the API