Support RFC 10008: HTTP `QUERY`

[ricardoboss]

Is your feature request related to a problem? Please describe the problem.

I'd like to use kiota to generate clients that can use the new HTTP verb QUERY (https://www.rfc-editor.org/info/rfc10008/).

It's currently not supported by the generator nor any client implementation.

Client library/SDK language

None

Describe the solution you'd like

I'd like kiota to consume an OpenAPI 3.2 spec with the fixed field query or an older spec version with additionalOperations to support custom verbs (see https://spec.openapis.org/oas/v3.2.0.html#fixed-fields-6), ideally both.

Additional context

I already discussed this with Vincent Biret (@baywet) and will work on an implementation for the generator side. Probably the Dart client libraries too.

[baywet]

Hi Ricardo Boss (@ricardoboss)
Thank you for using kiota and for reaching out.

In a lot of languages, we've modeled the http method as an enum

While that's not necessarily a problem for query (we can add a member), it'll be for arbitrary operations from additional operations. Changing to a string would be a source breaking change, there are some workarounds, but they are costly.

Since using bespoke http methods is a fairly niche scenario, I suggest we scope that issue to Query only, what do you think?

[ricardoboss]

Yeah I agree. Support for QUERY now, maybe support for custom verbs in the future.

[baywet]

Perfect! I think the first step then would be for all languages that use an enum to model the HTTP method, to add query there. This way we can release the packages and they are available to the generator for testing etc...