diff --git a/jsonschema-hyperschema.xml b/jsonschema-hyperschema.xml index 128da879..55cbe527 100644 --- a/jsonschema-hyperschema.xml +++ b/jsonschema-hyperschema.xml @@ -701,7 +701,7 @@ GET /foo/ -
+
This property provides a schema that is expected to describe the link target, including what a client can expect if it makes an HTTP GET request, and what it should send if it replaces the resource in an HTTP PUT request. This property is advisory only. @@ -855,11 +855,20 @@ GET /foo/ This property specifies that the client can construct a templated query or non-idempotent request to a resource. - If "method" is "get", the link identifies how a user can compute the URI of an arbitrary resource. For example, how to compute a link to a page of search results relating to the instance, for a user-selected query term. Despite being named after GET, there is no constraint on the method or protocol used to interact with the remote resource. + If "method" is "get", the link identifies how a user can compute the URI of an arbitrary resource. For example, how to compute a link to a page of search results relating to the instance, for a user-selected query term. If "method" is "post", the link specifies how a user can construct a document to submit to the link target for evaluation. + + Despite being named after HTTP's GET and POST, the presence, + absence, or value of this keyword does not impose any constraints + on either the method or protocol used to interact with the remote resource. + In particular, the same Link Description Object may be used + for multiple protocol methods. For protocol methods whose + request format is described by "targetSchema", + if "method" is "post" then "schema" is ignored. + Values for this property SHOULD be lowercase, and SHOULD be compared case-insensitive. Use of other values not defined here SHOULD be ignored. @@ -915,7 +924,7 @@ GET /foo/ - This is a separate concept from the "targetSchema" property, which is describing the target information resource (including for replacing the contents of the resource in a PUT request), unlike "schema" which describes the user-submitted request data to be evaluated by the resource. + This is a separate concept from the "targetSchema" property, which is describing the target information resource (including for replacing the contents of the resource in a PUT request), unlike "schema" which describes the user-submitted request data to be evaluated by the resource.