Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions aip/general/0136.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,8 @@ services. The bullets below apply in all three cases.
considered), a custom `CreateBookLongRunning` method could be introduced.
- The HTTP method **must** be `GET` or `POST`:
- `GET` **must** be used for methods retrieving data or resource state.
- `POST` **may** be used for data retieval methods if the request payload could
exceed URL size limitations, thus requiring a `body`.
- `POST` **must** be used if the method has side effects or mutates resources
or data.
- The HTTP URI **must** use a `:` character followed by the custom verb
Expand Down Expand Up @@ -188,6 +190,7 @@ languages.

## Changelog

- **2026-06-09:** Allow complex GET to be POST if necessary.
- **2025-05-12:** Extend disallowing prepositions rationale.
- **2025-01-09:** Add original rationale for disallowing prepositions in names.
- **2023-11-16:** Included link to AIP-127 "HTTP and gRPC Transcoding" for guidance on body definition.
Expand Down
Loading