ballerina-platform / ballerina-library

The Ballerina Library
https://ballerina.io/learn/api-docs/ballerina/
Apache License 2.0
137 stars 58 forks source link

Regenerate Ballerina Discord connector using the Discord's official openAPI v3.1.0 contract #6740

Open NipunaRanasinghe opened 2 months ago

NipunaRanasinghe commented 2 months ago

Description: Discord's latest OpenAPI contract (against the Discord REST API) is based on the OpenAPI 3.1.0 specification. However, the Ballerina OpenAPI tool currently has limited support for OpenAPI 3.1.x versions (https://github.com/ballerina-platform/ballerina-library/issues/6709). To address this, currently we've used a third-party tool to convert the original specification to OpenAPI v3.0.

Although this approach works, the converted specification used to generate the current connector has minor issues and vague definitions in some scenarios. Therefore, we need to consider regenerating the connector against their original spec, once our tool supports OpenAPI v3.1.x.

Describe your solution(s)

Related Issues (optional):

Suggested Labels (optional):

Suggested Assignees (optional):