You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"method" already documented that "method": "get" does not constrain
the LDO to GET. Clarify that "post" also does not constrain the
LDO to HTTP POST, and that the LDO can be used with multiple methods.
The "schema" and "targetSchema" keywords are used with relevant
HTTP methods regardless of the presence, absence, or value of
JSON Hyper-Schema LDO "method". This is consistent with the
existing wording of both "schema" and "targetSchema" around the
construction of PUT requests.
This property provides a schema that is expected to describe
708
708
the link target's representation. Depending on the protocol,
@@ -873,11 +873,20 @@ GET /foo/
873
873
This property specifies that the client can construct a templated query or non-idempotent request to a resource.
874
874
</t>
875
875
<t>
876
-
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.
876
+
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.
877
877
</t>
878
878
<t>
879
879
If "method" is "post", the link specifies how a user can construct a document to submit to the link target for evaluation.
880
880
</t>
881
+
<t>
882
+
Despite being named after HTTP's GET and POST, the presence,
883
+
absence, or value of this keyword does not impose any constraints
884
+
on either the method or protocol used to interact with the remote resource.
885
+
In particular, the same Link Description Object may be used
886
+
for multiple protocol methods. For protocol methods whose
887
+
request format is described by <xreftarget="targetSchema">"targetSchema"</xref>,
888
+
if "method" is "post" then <xreftarget="schema">"schema"</xref> is ignored.
889
+
</t>
881
890
<t>
882
891
Values for this property SHOULD be lowercase, and SHOULD be compared case-insensitive. Use of other values not defined here SHOULD be ignored.
883
892
</t>
@@ -933,7 +942,7 @@ GET /foo/
933
942
</t>
934
943
935
944
<t>
936
-
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.
945
+
This is a separate concept from the <xreftarget="targetSchema">"targetSchema"</xref> 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.
0 commit comments