| draft-ietf-httpbis-safe-method-w-body-12.txt | draft-ietf-httpbis-safe-method-w-body-latest.txt | |||
|---|---|---|---|---|
| HTTP Working Group J. Reschke | HTTP Working Group J. Reschke | |||
| Internet-Draft greenbytes | Internet-Draft greenbytes | |||
| Intended status: Standards Track J.M. Snell | Intended status: Standards Track J.M. Snell | |||
| Expires: April 2, 2026 Cloudflare | Expires: May 1, 2026 Cloudflare | |||
| M. Bishop | M. Bishop | |||
| Akamai | Akamai | |||
| September 29, 2025 | October 28, 2025 | |||
| The HTTP QUERY Method | The HTTP QUERY Method | |||
| draft-ietf-httpbis-safe-method-w-body-12 | draft-ietf-httpbis-safe-method-w-body-latest | |||
| Abstract | Abstract | |||
| This specification defines the QUERY method for HTTP. A QUERY | This specification defines the QUERY method for HTTP. A QUERY | |||
| requests that the request target process the enclosed content in a | requests that the request target process the enclosed content in a | |||
| safe/idempotent manner and then respond with the result of that | safe/idempotent manner and then respond with the result of that | |||
| processing. This is similar to POST requests but can be | processing. This is similar to POST requests but can be | |||
| automatically repeated or restarted without concern for partial state | automatically repeated or restarted without concern for partial state | |||
| changes. | changes. | |||
| skipping to change at page 1, line 35 ¶ | skipping to change at page 1, line 35 ¶ | |||
| This note is to be removed before publishing as an RFC. | This note is to be removed before publishing as an RFC. | |||
| Discussion of this draft takes place on the HTTP working group | Discussion of this draft takes place on the HTTP working group | |||
| mailing list (ietf-http-wg@w3.org), which is archived at | mailing list (ietf-http-wg@w3.org), which is archived at | |||
| <https://lists.w3.org/Archives/Public/ietf-http-wg/>. | <https://lists.w3.org/Archives/Public/ietf-http-wg/>. | |||
| Working Group information can be found at <https://httpwg.org/>; | Working Group information can be found at <https://httpwg.org/>; | |||
| source code and issues list for this draft can be found at | source code and issues list for this draft can be found at | |||
| <https://github.com/httpwg/http-extensions/labels/query-method>. | <https://github.com/httpwg/http-extensions/labels/query-method>. | |||
| The changes in this draft are summarized in Appendix B.12. | The changes in this draft are summarized in Appendix B.13. | |||
| Status of This Memo | Status of This Memo | |||
| This Internet-Draft is submitted in full conformance with the | This Internet-Draft is submitted in full conformance with the | |||
| provisions of BCP 78 and BCP 79. | provisions of BCP 78 and BCP 79. | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
| working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
| Drafts is at https://datatracker.ietf.org/drafts/current/. | Drafts is at https://datatracker.ietf.org/drafts/current/. | |||
| Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
| and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
| time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
| material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
| This Internet-Draft will expire on April 2, 2026. | This Internet-Draft will expire on May 1, 2026. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2025 IETF Trust and the persons identified as the | Copyright (c) 2025 IETF Trust and the persons identified as the | |||
| document authors. All rights reserved. | document authors. All rights reserved. | |||
| This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
| Provisions Relating to IETF Documents (https://trustee.ietf.org/ | Provisions Relating to IETF Documents (https://trustee.ietf.org/ | |||
| license-info) in effect on the date of publication of this document. | license-info) in effect on the date of publication of this document. | |||
| Please review these documents carefully, as they describe your rights | Please review these documents carefully, as they describe your rights | |||
| skipping to change at page 3, line 22 ¶ | skipping to change at page 3, line 22 ¶ | |||
| B.3. Since draft-ietf-httpbis-safe-method-w-body-02 . . . . . 26 | B.3. Since draft-ietf-httpbis-safe-method-w-body-02 . . . . . 26 | |||
| B.4. Since draft-ietf-httpbis-safe-method-w-body-03 . . . . . 26 | B.4. Since draft-ietf-httpbis-safe-method-w-body-03 . . . . . 26 | |||
| B.5. Since draft-ietf-httpbis-safe-method-w-body-04 . . . . . 26 | B.5. Since draft-ietf-httpbis-safe-method-w-body-04 . . . . . 26 | |||
| B.6. Since draft-ietf-httpbis-safe-method-w-body-05 . . . . . 26 | B.6. Since draft-ietf-httpbis-safe-method-w-body-05 . . . . . 26 | |||
| B.7. Since draft-ietf-httpbis-safe-method-w-body-06 . . . . . 27 | B.7. Since draft-ietf-httpbis-safe-method-w-body-06 . . . . . 27 | |||
| B.8. Since draft-ietf-httpbis-safe-method-w-body-07 . . . . . 28 | B.8. Since draft-ietf-httpbis-safe-method-w-body-07 . . . . . 28 | |||
| B.9. Since draft-ietf-httpbis-safe-method-w-body-08 . . . . . 28 | B.9. Since draft-ietf-httpbis-safe-method-w-body-08 . . . . . 28 | |||
| B.10. Since draft-ietf-httpbis-safe-method-w-body-09 . . . . . 28 | B.10. Since draft-ietf-httpbis-safe-method-w-body-09 . . . . . 28 | |||
| B.11. Since draft-ietf-httpbis-safe-method-w-body-10 . . . . . 28 | B.11. Since draft-ietf-httpbis-safe-method-w-body-10 . . . . . 28 | |||
| B.12. Since draft-ietf-httpbis-safe-method-w-body-11 . . . . . 29 | B.12. Since draft-ietf-httpbis-safe-method-w-body-11 . . . . . 29 | |||
| B.13. Since draft-ietf-httpbis-safe-method-w-body-12 . . . . . 29 | ||||
| Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 30 | Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 30 | |||
| Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 30 | Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 30 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 30 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 30 | |||
| 1. Introduction | 1. Introduction | |||
| This specification defines the HTTP QUERY request method as a means | This specification defines the HTTP QUERY request method as a means | |||
| of making a safe, idempotent request (Section 9.2 of [HTTP]) | of making a safe, idempotent request (Section 9.2 of [HTTP]) | |||
| containing content that describes how the request is to be processed | containing content that describes how the request is to be processed | |||
| by the target resource. | by the target resource. | |||
| skipping to change at page 30, line 5 ¶ | skipping to change at page 29, line 50 ¶ | |||
| o Consistent Table Captions (<https://github.com/httpwg/http- | o Consistent Table Captions (<https://github.com/httpwg/http- | |||
| extensions/issues/3134>) | extensions/issues/3134>) | |||
| o Define "Equivalent Resource", update description of Conditional | o Define "Equivalent Resource", update description of Conditional | |||
| Requests, add examples (<https://github.com/httpwg/http- | Requests, add examples (<https://github.com/httpwg/http- | |||
| extensions/issues/3137>) | extensions/issues/3137>) | |||
| o Extend discussion of Range Requests (<https://github.com/httpwg/ | o Extend discussion of Range Requests (<https://github.com/httpwg/ | |||
| http-extensions/issues/3151>) | http-extensions/issues/3151>) | |||
| B.13. Since draft-ietf-httpbis-safe-method-w-body-12 | ||||
| o Ack Asbjørn Ulsberg (<https://github.com/httpwg/http-extensions/ | ||||
| issues/3299>) | ||||
| Acknowledgements | Acknowledgements | |||
| We thank all members of the HTTP Working Group for ideas, reviews, | We thank all members of the HTTP Working Group for ideas, reviews, | |||
| and feedback. | and feedback. | |||
| The following individuals deserve special recognition: Carsten | The following individuals deserve special recognition: Carsten | |||
| Bormann, Mark Nottingham, Martin Thomson, Michael Thornburgh, Roberto | Bormann, Mark Nottingham, Martin Thomson, Michael Thornburgh, Roberto | |||
| Polli, Roy Fielding, and Will Hawkins. | Polli, Roy Fielding, and Will Hawkins. | |||
| Contributors | Contributors | |||
| Ashok Malhotra participated in early discussions leading to this | Ashok Malhotra participated in early discussions leading to this | |||
| specification: | specification: | |||
| Ashok Malhotra | Ashok Malhotra | |||
| Email: malhotrasahib@gmail.com | Email: malhotrasahib@gmail.com | |||
| Discussion on the this HTTP method was reopened by Asbjørn Ulsberg | ||||
| during the HTTP Workshop in 2019: | ||||
| Asbjørn Ulsberg | ||||
| Email: asbjorn@ulsberg.no | ||||
| URI: https://asbjor.nu/ | ||||
| Authors' Addresses | Authors' Addresses | |||
| Julian Reschke | Julian Reschke | |||
| greenbytes GmbH | greenbytes GmbH | |||
| Hafenweg 16 | Hafenweg 16 | |||
| 48155 Münster | 48155 Münster | |||
| Germany | Germany | |||
| Email: julian.reschke@greenbytes.de | Email: julian.reschke@greenbytes.de | |||
| URI: https://greenbytes.de/tech/webdav/ | URI: https://greenbytes.de/tech/webdav/ | |||
| End of changes. 8 change blocks. | ||||
| 5 lines changed or deleted | 17 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||