File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -51,6 +51,8 @@ services. The bullets below apply in all three cases.
5151 considered), a custom ` CreateBookLongRunning ` method could be introduced.
5252- The HTTP method ** must** be ` GET ` or ` POST ` :
5353 - ` GET ` ** must** be used for methods retrieving data or resource state.
54+ - ` POST ` ** may** be used for data retieval methods if the request payload could
55+ exceed URL size limitations, thus requiring a ` body ` .
5456 - ` POST ` ** must** be used if the method has side effects or mutates resources
5557 or data.
5658- The HTTP URI ** must** use a ` : ` character followed by the custom verb
@@ -188,6 +190,7 @@ languages.
188190
189191## Changelog
190192
193+ - ** 2026-06-09:** Allow complex GET to be POST if necessary.
191194- ** 2025-05-12:** Extend disallowing prepositions rationale.
192195- ** 2025-01-09:** Add original rationale for disallowing prepositions in names.
193196- ** 2023-11-16:** Included link to AIP-127 "HTTP and gRPC Transcoding" for guidance on body definition.
You can’t perform that action at this time.
0 commit comments