We made a tool to help developers improve OpenAPI specs

Hacker News

Hey, I'm Martyn and I recently joined Zuplo. OpenAPI is a huge part of what we do, but getting a document up to scratch out of the gate, especially if you're not super well versed in the actual specification and what you should use and when. So we built a suite of tools to help with this called Rate My OpenAPI. It will score your OpenAPI document out of 100, as well as giving you individual scores in 4 key areas; completeness, SDK generation, security and documentation. Along with the score, you also get details of what the issues, or errors are, as well as guidance on what they actually mean and why they're important. We exposed the API for it using Zuplo, and then built a CLI, and a GitHub Action on top of that so that you can add Rate My OpenAPI into your workflow however you like. You can check it out and use all of this right now, for free. I've already found it extremely useful and I hope you do to. Feedback is absolutely welcome!

Visit product View on Hacker NewsAug 14, 2024

Share card

Actual performance

105points

20comments

Made the leaderboard

Launch Intel predictions

Analyze your own launch →

Indie HackersFits the IH revenue-focused audience · Missing: supports, reddit linkedin, podcasting

66%66% predicted probability of success on Indie Hackers, based on ML models trained on real launch data.

best fitHighest predicted score across all platforms for this description.

Product HuntOn track for Day 1 leaderboard · Strong signals: using, open · Missing: mac, agents, macos

60%60% predicted probability of success on Product Hunt, based on ML models trained on real launch data.

AppSumoMay struggle as an AppSumo deal · Missing: plus, platform, intuitive

44%44% predicted probability of success on AppSumo, based on ML models trained on real launch data.

Hacker NewsMay not resonate with HN audience · Strong signals: io · Missing: https docs, excited, just released

43%43% predicted probability of success on Hacker News, based on ML models trained on real launch data.

nativeThis product was originally launched on this platform.

TrustMRRLess likely to generate early MRR · Missing: mobile apps, ios, personal

36%36% predicted probability of success on TrustMRR, based on ML models trained on real launch data.

Acquire.comPre-revenue stage for this audience · Missing: arr, mrr, revenue

12%12% predicted probability of success on Acquire.com, based on ML models trained on real launch data.

BetaListMay not resonate with beta-testers · Missing: web3, chat, crypto

0%0% predicted probability of success on BetaList, based on ML models trained on real launch data.

Incorrect prediction on native model

Similar products

MandaEmprego39%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

A tool to help people to improve their curriculum

Indie Hackers1jobs-hiring

should_not, a gem to enforce that specs do not begin with "should"36%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

should_not, a gem to enforce that specs do not begin with "should"

Hacker News3

From Argentina, help to improve about-to-be-launched site45%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

From Argentina, help to improve about-to-be-launched site

Hacker News2

I built a small tool to help teams improve their culture28%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

I built a small tool to help teams improve their culture

Hacker News2

An App to help improve throughput of Covid-19 Test Kits44%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

An App to help improve throughput of Covid-19 Test Kits

Hacker News4

Newsletter to help developers improve their written communication46%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Newsletter to help developers improve their written communication

Hacker News1

VibeSpec – A tool to generate structured specs for Spec2Code50%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

VibeSpec – A tool to generate structured specs for Spec2Code

Hacker News1

DevBooks – Help Developers find indy books57%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

DevBooks – Help Developers find indy books

Hacker News124

BetterArgs – A string parsing tool to help build CLIs44%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

BetterArgs – A string parsing tool to help build CLIs

Hacker News1

A habit tracker to help developers improve their posture52%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

A habit tracker to help developers improve their posture

Hacker News1

Browse all products Analyze your launch