I'm trying to understand the approach to WebAPI descriptions using potential actions, studying https://schema.org/docs/actions.html. In the "Example: Movie review site API with -input and -output" section, there is:
description
Since there are no parameters in the URI template, but some input must be provided by a request, it would appear that the service requires a POST request? Is "object" necessary if the ur template has parameters, in which case they are specified using query-input/PropertyValueSpecification?
I'm trying to understand the approach to WebAPI descriptions using potential actions, studying https://schema.org/docs/actions.html. In the "Example: Movie review site API with -input and -output" section, there is: description
And an example request: Request
Shouldn't the object have a url property to match the "url-input" in the description?
so the object in the Request would be
Also, since the request is a POST, shouldn't the description include
Since there are no parameters in the URI template, but some input must be provided by a request, it would appear that the service requires a POST request? Is "object" necessary if the ur template has parameters, in which case they are specified using query-input/PropertyValueSpecification?
Please see comments in the example doc at https://github.com/earthcubearchitecture-ecresourcereg/p419dcatservices/blob/SMR-CHORDSwebAPI/ChordsWebAPIv2.jsonld
@ashepherd you might be interested in this discussion as well...