5 ms·

Hi, I'm the author, and I definitely know about Swagger/OpenAPI. By coincidence, I'm maintainer of the collection of 250+ Swagger specs for public APIs: https:

Hi, I'm the author, and I definitely know about Swagger/OpenAPI. By coincidence, I'm maintainer of the collection of 250+ Swagger specs for public APIs: https://github.com/APIs-guru/openapi-directory https://github.com/APIs-guru/openapi-directory But I have learned the hard truth over last two years: API catalogs aren't scalable solutions for API discovery. That's why I'm pushing this. P.S. it is pretty easy to generate Schema.org type based on Swagger/OpenAPI spec.

alemhnan 10y ago
Would you mind to share a link for that? I am very interested as I work on different projects with swagger apis.
- romanhotsiy 10y ago
  Here is the main site: https://apis.guru https://apis.guru And here is github repo: https://github.com/APIs-guru/openapi-directory https://github.com/APIs-guru/openapi-directory
  - alemhnan 10y ago
    thanks a lot!
oneweekwonder 10y ago
> I'm maintainer of the collection of 250+ Swagger specs for public APIs: https://github.com/APIs-guru/openapi-directory https://github.com/APIs-guru/openapi-directory Ah cool, thanks for the link and effort. Will have a look at it as time allow. > It is pretty easy to generate Schema.org type based on Swagger/OpenAPI spec. Do you have any example or gist of a snipped of code to accomplish this? > API catalogs aren't scalable solutions for API discovery. That's why I'm pushing this. But does the API catalog not enable auto discovery? Agreeing you maintaining a list is not scalable.
- stephenhuey 10y ago
  In case this helps, the menu for apis.guru doesn't seem to be working on my iPhone 6s in Chrome or Safari. Actually, it just doesn't work on the homepage. It works if I go to the Browse APIs page.
  - romanhotsiy 10y ago
    Thanks! That helped! Fixed now
agentgt 10y ago
> But I have learned the hard truth over last two years: API catalogs aren't scalable solutions for API discovery. That's why I'm pushing this. Minor critique but the word "discovery" particularly in terms of service oriented is heavily overloaded. It took me a little while to understand what the article meant by discovery and I'm still not entirely sure I do. Do you mean this discovery: https://en.wikipedia.org/wiki/Service_discovery https://en.wikipedia.org/wiki/Service_discovery or do you mean a discovery more in the human sense (ie a consumer search directory listing API services)?

alemhnan 10y ago

Would you mind to share a link for that? I am very interested as I work on different projects with swagger apis.

romanhotsiy 10y ago
Here is the main site: https://apis.guru https://apis.guru And here is github repo: https://github.com/APIs-guru/openapi-directory https://github.com/APIs-guru/openapi-directory
- alemhnan 10y ago
  thanks a lot!

oneweekwonder 10y ago

> I'm maintainer of the collection of 250+ Swagger specs for public APIs: https://github.com/APIs-guru/openapi-directory https://github.com/APIs-guru/openapi-directory Ah cool, thanks for the link and effort. Will have a look at it as time allow. > It is pretty easy to generate Schema.org type based on Swagger/OpenAPI spec. Do you have any example or gist of a snipped of code to accomplish this? > API catalogs aren't scalable solutions for API discovery. That's why I'm pushing this. But does the API catalog not enable auto discovery? Agreeing you maintaining a list is not scalable.

stephenhuey 10y ago
In case this helps, the menu for apis.guru doesn't seem to be working on my iPhone 6s in Chrome or Safari. Actually, it just doesn't work on the homepage. It works if I go to the Browse APIs page.
- romanhotsiy 10y ago
  Thanks! That helped! Fixed now

agentgt 10y ago

> But I have learned the hard truth over last two years: API catalogs aren't scalable solutions for API discovery. That's why I'm pushing this. Minor critique but the word "discovery" particularly in terms of service oriented is heavily overloaded. It took me a little while to understand what the article meant by discovery and I'm still not entirely sure I do. Do you mean this discovery: https://en.wikipedia.org/wiki/Service_discovery https://en.wikipedia.org/wiki/Service_discovery or do you mean a discovery more in the human sense (ie a consumer search directory listing API services)?