meshery icon indicating copy to clipboard operation
meshery copied to clipboard

Migrate APIs to be schema-driven

Open Yashsharma1911 opened this issue 1 year ago • 6 comments

Description: Enhance Meshery’s APIs capability by migrating to a schema-driven approach, which will ensure consistency, validation, and easier integration. It involves versioning and defining API schemas using OpenAPI/Swagger at https://github.com/meshery/schemas and auto generating structs. You will be ensuring all Meshery APIs aligns with defined schemas and are consistent.

  • Expected Outcome: Identifying APIs and updating them to conform these schemas. Enhance API documentation to reflect the schema-driven approach. Updating APIs to ensure they are consistent and doing validation against defined schemas.

  • Recommended Skills: Golang, Kubernetes, Swagger, JSON schemas, familiarity with React, Nextjs would be helpful

  • Mentor(s): Lee Calcote (@leecalcote, [email protected]), Yash Sharma (@Yashsharma1911, [email protected])


Contributor Guides and Handbook

Yashsharma1911 avatar Jul 30 '24 20:07 Yashsharma1911

Hi @Yashsharma1911,

I am interested in working on this project for LFX Mentorship. I have a question regarding the project agenda:- Are all the APIs in the meshery repository going to be built from scratch using a schema-driven approach/Swagger.

Thank You.

upsaurav12 avatar Aug 02 '24 17:08 upsaurav12

Hi @Yashsharma1911, I am very interested to take up this task in LFX term 3.

rahulbansal3005 avatar Aug 03 '24 17:08 rahulbansal3005

Hello, I am interested in contributing to this issue as part of the LFX mentorship program

Omarabdul3ziz avatar Aug 14 '24 20:08 Omarabdul3ziz

Hey @Yashsharma1911, just wanted to know by when will the mentee be selected for this project ? Because I think the deadline was 27 Aug 5.00 AM PDT.

Ash-2k3 avatar Aug 28 '24 13:08 Ash-2k3

@Omarabdul3ziz @rahulbansal3005, great. Start participating.

@Ash-2k3 selection is based on supporting existing contributors. I encourage you to start participating today. The weekly Meshery Dev meeting starts in a few minutes...

@upsaurav12, good job on getting engaged and involved in the projects here.

leecalcote avatar Aug 28 '24 13:08 leecalcote

Sure, thankks!!!

Ash-2k3 avatar Aug 28 '24 14:08 Ash-2k3

Meshery’s APIs

From where can I find Meshery’s APIs documentations?

prachinandi avatar Sep 30 '24 13:09 prachinandi

@prachinandi here - https://docs.meshery.io/extensibility/api

leecalcote avatar Sep 30 '24 18:09 leecalcote

@prachinandi, in fact, that page needs a small update to include ``` or <pre> around the two API path references at the bottom of the page (e.g. /api/perf). Open a PR, if you'd like to fix it...

leecalcote avatar Sep 30 '24 18:09 leecalcote

@prachinandi, in fact, that page needs a small update to include ``` or \<pre\> around the two API path references at the bottom of the page (e.g. /api/perf). Open a PR, if you'd like to fix it...

Done! https://github.com/meshery/meshery/pull/12215

prachinandi avatar Oct 02 '24 14:10 prachinandi