Azure / Azure/azure-functions-openapi-extension

Extend definition objects with custom properties - support Power Apps Custom Connector definition

Open
#231 3 comments 1 reaction 0 assignees View on GitHub
enhancement
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.