swagger-api / swagger-api/swagger-codegen
Schema generation for AsyncApi
Nobody has claimed this yet.
- Dominant language
- Mustache
- Stars
- 17.8k
- Forks
- 6k
- PR merge metrics
- No merged PRs in 30d
Description
Hi. I'm interested in integrating the AsyncApi tool (https://www.asyncapi.com/) with Swagger. It would be great to have the ability to get their schema via some endpoint like it is implemented for rest API in /v3/api-docs.
As I see, if AsyncApi is in the service, this endpoint doesn't recognize it and doesn't write to the schema. Possibly, do you have something for AsyncApi or plan integration with it??
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the existing /v3/api-docs endpoint and the AsyncApi tool referenced in the issue. Determine whether AsyncAPI schemas are intended to be exposed through this integration and what endpoint behavior is required. Done means a documented, tested approach for retrieving the AsyncAPI schema, if the project supports it.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- api
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100