search

apis-json / api-json

APIS.json an API discovery format
http://apisjson.org/
MIT License
111 stars 23 forks source link

Current Status (early 2024) #77

Closed ChristophWeber closed 5 months ago

ChristophWeber commented 10 months ago

Hi all, what is the status of apis.json? Any plans to push it further? I noticed that WebAPI Schema RFC references apis.json (as well as some other related data formats). However WebAPI Schema has stalled too.

For context, I work with Kristof van Tomme at Pronovix and we are keenly interested in implementing a structured API description format that aids API discoverability and eventually, automated integration. In the age of AI we think it is more imperative than ever to have machine readable and discoverable API catalogs available as entry points into an organization's API operations. We would love to work with anyone to make an agreed upon structured API description format real on many organization portals and promote its use.

Kevsy commented 10 months ago

Hi all, what is the status of apis.json? Any plans to push it further?

I'm interested in the answer too - I'm editor of an IETF draft, api-catalog: A well-known URI to help discovery of APIs , and was hoping to recommend apis.json as a format for the API Catalog itself.

ChristophWeber commented 10 months ago

That's a great RFC @Kevsy! I too was thinking that .well-known/ is the better place for apis.json than directly at the root of the web server. Glad to see a push in that direction. Now we need an answer from @kinlane or @njyx.

kinlane commented 9 months ago

Hello. Yes, we are working on proposal for 0.17 currently. Will share ASAP.

kinlane commented 9 months ago

We were working on getting more implementations of WebAPI Schema RFC, but as you note, it has stalled. We'll find some more energy for that as well.

ChristophWeber commented 9 months ago

That is great news all around, thank you! Let us know how we can help.

kinlane commented 9 months ago

OK, I have published a proposal for .17, please share any thoughts - https://github.com/apis-json/api-json/issues/79 - I am going to step back and consider big picture, and see what else is needed right now for the spec. I have been primarily focused on APIs.io and the Artisanal index.

ChristophWeber commented 8 months ago

Thanks, I will comment on the proposal and other issues. Let's close this issue to keep things tidy.