search

microsoft / kiota

OpenAPI based HTTP Client code generator
https://aka.ms/kiota/docs
MIT License
3.01k stars 210 forks source link

Add support for additional registries for search and download commands #1866

Closed baywet closed 2 years ago

baywet commented 2 years ago

1864 added support for searching and downloading descriptions from public registries. (apis.guru, hardcoded MS Graph).

We should add support for additional registries to broaden the set of results.

One such candidate could be apigee registry which is a solution that can be hosted and accessed privately (internal APIs). It also seems to be what google uses publicly.

https://developers.google.com/discovery/v1/reference/apis/list https://apigee.github.io/registry/ https://apigee.github.io/registry/api.html#google.cloud.apigeeregistry.v1.ListApisRequest

We should:

baywet commented 2 years ago

github through label + naming conventions

darrelmiller commented 2 years ago

Here's the plan.

Kiota should search GitHub for repositories for the topic openapi-index or kiota-index and look for an apis.json file or apis.yaml file in the root that matches the apis.json specification http://apisjson.org/format/apisjson_0.16.txt Kiota should use this document to discover OpenAPI descriptions and make them available in Kiota search results.