Add -AllowNonStandardBody Parameter to Enable Request Bodies for Non-Standard HTTP Methods in OpenAPI

[mdaneri]

Description

This pull request introduces a new -AllowNonStandardBody parameter to enable request bodies for HTTP methods that typically do not support them, such as GET and DELETE. By default, Pode adheres to the RFC 7231 standards, which generally reserve request bodies for POST, PUT, and PATCH methods. However, this update provides flexibility for users who require bodies for other HTTP methods, addressing the feature request and limitations outlined in issue #1432.

Changes

• New Parameter: The -AllowNonStandardBody switch is added to the Set-PodeOARequest function. When specified, this parameter overrides the default behavior, allowing non-standard HTTP methods to include a request body.
• Enhanced Error Messaging: The exception message has been updated to suggest using -AllowNonStandardBody for methods where request bodies are typically disallowed, improving guidance for users.
• Localization: The updated error message has been translated into multiple languages, including Arabic, German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, and Chinese, to support international users.

Example

To define a route that allows a request body for a DELETE operation:

Add-PodeRoute -Method DELETE -Path '/resource' -PassThru | Set-PodeOARequest -RequestBody (New-PodeOARequestBody -Schema 'DeleteRequestSchema') -AllowNonStandardBody

Issue Addressed

• Fixes OpenAPI 3.1 supports Body for DELETE method #1432: Implements an optional relaxation of RFC 7231 by allowing request bodies for GET, DELETE, and other HTTP methods upon user request.

Testing

• Unit tests were added to ensure that the -AllowNonStandardBody parameter enables request bodies for HTTP methods like DELETE.
• Tests verify that without -AllowNonStandardBody, the function continues to restrict bodies to POST, PUT, and PATCH.