Feature request: Add support for headers parameters in OpenAPI schema

[leandrodamascena]

Use case

Original discussion: #3609

OpenAPI supports Headers parameters and we must add support for this!

https://swagger.io/docs/specification/describing-parameters/

Header Parameters

An API call may require that custom headers be sent with an HTTP request. OpenAPI lets you define custom request headers as in: header parameters.

Solution/User Experience

Add Header in https://github.com/aws-powertools/powertools-lambda-python/blob/develop/aws_lambda_powertools/event_handler/openapi/params.py

Alternative solutions

No response

Acknowledgment

• This feature request meets Powertools for AWS Lambda (Python) Tenets
• Should this be considered in other Powertools for AWS Lambda languages? i.e. Java, TypeScript, and .NET

[leandrodamascena]

Assigned to @rubenfonseca