draft-ietf-httpbis-safe-method-w-body.xml

<?xml version="1.0" encoding="UTF-8" ?>
<service primary="IETF" secondary="I-D" id="ietf-httpbis-safe-method-w-body">
    <title>The HTTP QUERY Method</title>
    <documentation source="https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-safe-method-w-body">This specification defines a new HTTP method, QUERY, as a safe, idempotent request method that can carry request content.</documentation>
    <http-method def="QUERY">
        <documentation source="https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-safe-method-w-body#section-2">The QUERY method is used to initiate a server-side query. Unlike the HTTP GET method, which requests that a server return a representation of the resource identified by the target URI, the QUERY method is used to ask the server to perform a query operation (described by the request payload) over some set of data scoped to the effective request URI. The payload returned in response to a QUERY cannot be assumed to be a representation of the resource identified by the effective request URI.</documentation>
    </http-method>
    <http-header def="Accept-Query">
        <documentation source="https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-safe-method-w-body#section-3">The "Accept-Query" response header field MAY be used by a server to directly signal support for the QUERY method while identifying the specific query format media type(s) that may be used.</documentation>
    </http-header>
</service>