Hacker News new | ask | show | jobs
by blondin 1202 days ago
would be nice if it explains why OpenAPI 3.0.0-compliance (with comments, examples, etc.) matters.
1 comments

Yes! I assume that this is just content marketing to get link juice to feed our Google overlords, but yeesh.

I run a SaaS that helps people get API data into Google Sheets.

For very popular services, we make customized connectors that hide all the complexity.

For medium popularity services, we do some automated transforms to hide complexity in the requests, and massage the response shape to an easier-to-consume format.

For low popularity services, we'll do a best-effort to point customers towards docs and common pitfalls.

All of that is to say: I've seen a lot of APIs!

So it's very bizarre to see Xero ranked #3 out of 5,651. Xero has this convoluted system where you need to query to get your tenant ID, and then pass that as a header. If you don't pass it, you get an opaque error message. That's the 3rd best API, eh?

Also, you sort of have to wonder how much human review went into this. GitHub has an OpenAPI spec, is a hugely popular service, and seems to be absent from this index.

(edit: Perhaps Github is present? I got no results when I searched "github", but I also get no results if I search "xero", despite Xero Assets API being the 3rd hit.)

What SaaS is it? I think I have a feel for exactly this