Azure / Azure/azure-functions-openapi-extension
Extend definition objects with custom properties - support Power Apps Custom Connector definition
- Dominant language
- C#
- Stars
- 388
- Forks
- 202
- PR merge metrics
- No merged PRs in 30d
Description
Hi,
I have a need to set some custom parameters into openapi definition.
To be more specific I need my swagger definition to be compliant with Microsoft Power Apps Custom Connector rules: https://docs.microsoft.com/en-us/connectors/custom-connectors/openapi-extensions
For example, every parameter in my definition has to have "x-ms-summary" defined to pass the validator.
Can you please provide an example on how to achieve this or update the library to support it?
Contributor guide
Research direction
Start by reviewing how the extension emits OpenAPI definition objects and compare the generated parameter metadata with Microsoft's Power Apps Custom Connector OpenAPI extensions guidance. Done means there is a documented or implemented way to include custom properties such as x-ms-summary and the resulting definition satisfies the stated validator requirements.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp, openapi
- Domain
- api
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100