frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

Open in hackernews

A Deep Dive into OpenAPI

https://www.deployhq.com/blog/unlocking-seamless-development-and-collaboration-a-deep-dive-into-openapi
14•whatatimeline•5h ago

Comments

waldekm•4h ago
Another way to create an API spec is by using Dev Proxy: https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/ho.... It’s an easy way to get started from an existing API.
deployhq•2h ago
Thanks for sharing it!
andregit•3h ago
so...yaml for the win? :))
deployhq•2h ago
So, we ended up by using https://rubygems.org/gems/oas_rails which does the heavy work and generates almost everything. We only had to document the endpoints.
cyberax•3h ago
Ugh. OpenAPI: just say "no". It's WAY too verbose, and there are usually many ways to shoot yourself in the foot.

Protobuf-based APIs are much nicer to work with. Either via gRPC, or via ConnectRPC.

ludovicianul•3h ago
I would say being verbose is a positive thing. It removes the need of having additional (and usually out-of-sync) documentation. Plus all the tooling around it that allows you to keep public Dev documentation in sync with min effort.
resonious•3h ago
Agreed. The extra stuff you get "for free" from the OpenAPI ecosystem is well worth the extra time it takes to write the spec.

If you don't want things like client/server generators and documentation, then sure it's not great

cyberax•3h ago
You still need to write a spec with protobufs. It's just that the spec is much more succinct and easy to read. And you can generate docs from it. E.g.:

https://cloud.google.com/appengine/docs/admin-api/reference/...

Do an experiment, take a Protobuf spec for some Google API and convert it into OpenAPI.

deployhq•2h ago
We have used the gem: https://github.com/a-chacon/oas_rails, and we didn't need to write the specs, just comment the endpoints
cyberax•3h ago
> I would say being verbose is a positive thing.

No, it's not. A description of a single method can often span a couple of screens, and still not cover everything.

In addition, YAML is not easily composable, so you end up with files that are megabytes in size. This is completely useless for humans, unless you start using third-party tools to split the file into parts.

Protobuf-based protocols are also much better specified, and they don't have multiple ways to pass in data. Meanwhile, OpenAPI supports: headers, path queries, multiparts, forms with various encodings, uploads, etc.

dankobgd•3h ago
So ai blog is now a "deep dive"
what-the-grump•3h ago
Without a single line of code or example. Help I’m drowning.
deployhq•2h ago
We ended up using this gem to implement OpenAPI: https://github.com/a-chacon/oas_rails, it was quite straightforward
speed_spread•3h ago
Not sure about the corporate advertising tone of the article, but I love OpenAPI. Having to work with various third party HTTP/JSON APIs all the time, I know I would rather deal with imperfect rigid generated client code than half-assed specs and shoddy examples. As a bonus, you can also generate your own server emulation for local testing, which is worth gold when dealing with real hardware.

The Portable Memory Wallet Fallacy: Four Fundamental Problems

https://blog.getzep.com/the-portable-memory-wallet-fallacy-four-fundamental-problems/
1•roseway4•4m ago•0 comments

opencode - AI coding agent built for the terminal

https://github.com/opencode-ai/opencode
2•l1am0•6m ago•0 comments

Recipes – A Pattern for Common Code Transformations

http://arcturus-labs.com/blog/2025/06/17/recipes--a-pattern-for-common-code-transformations/
1•JnBrymn•7m ago•0 comments

Alaska just hit a climate milestone – its first-ever heat advisory

https://grist.org/extreme-heat/alaska-just-hit-a-climate-milestone-its-first-heat-advisory/
2•Brajeshwar•9m ago•0 comments

Anita did see weird particles, but not parallel Universes

https://bigthink.com/starts-with-a-bang/evidence-parallel-universe/
1•Brajeshwar•9m ago•0 comments

Smart TV OS owners face "constant conflict" between privacy, advertiser demands

https://arstechnica.com/gadgets/2025/06/tv-brands-face-inherent-conflict-over-user-privacy-advertiser-data-demands/
1•Brajeshwar•9m ago•0 comments

Washington targets speeders with cellphone data

https://www.king5.com/article/news/local/cellphone-data-help-state-patrol-catch-speeding-drivers-washington/281-2988e838-320f-4c2f-b2f9-89b17317bcfa
2•josephcsible•11m ago•0 comments

Graph-Based Codebase Understanding

https://github.com/vitali87/code-graph-rag
3•vitali87•11m ago•0 comments

How 'Jaws' Made a Template for the Modern Blockbuster

https://www.nytimes.com/interactive/2025/06/18/upshot/jaws-at-50.html
1•ChrisArchitect•12m ago•1 comments

The Great Egg Heist

https://www.washingtonpost.com/investigations/interactive/2025/eggs-prices-gouging-cal-maine-investigation/
1•tintinnabula•13m ago•0 comments

Claude, Employee of the Month

https://chorus.sh/blog/claude-employee-of-the-month
1•Charlieholtz•15m ago•0 comments

Posit floating point numbers: thin triangles and other tricks (2019)

http://marc-b-reynolds.github.io/math/2019/02/06/Posit1.html
5•fanf2•16m ago•0 comments

Restaure suas fotos antigas gratuitamente com IA – Melhorar Imagem

https://melhoraimagem.space
1•banner520•16m ago•0 comments

The Gap Through Which We Praise the Machine

https://ferd.ca/the-gap-through-which-we-praise-the-machine.html
2•sausagefeet•16m ago•0 comments

How many R's are in this image of a strawberry?

https://beklein.com/posts/strawberry/
2•beklein•20m ago•0 comments

Haven-1 Space Station Design by Vast

https://www.vastspace.com/updates/vast-unveils-its-final-haven-1-space-station-design
1•Neuronaut•20m ago•0 comments

How the brain turns stress into a bad night's sleep

https://www.nature.com/articles/d41586-025-01910-6
1•rntn•20m ago•0 comments

Machine Learning for Sports Prediction: Include the Odds? Balance the Winrate?

https://mma-ai.net/news
1•DanMcInerney•21m ago•0 comments

What Does a Cartographer Do?

https://www.indeed.com/career-advice/finding-a-job/what-is-cartographer
1•squircle•22m ago•0 comments

OWASP Top 10 for Business Logic Abuse

https://owasp.org/www-project-top-10-for-business-logic-abuse/
2•crescit_eundo•22m ago•0 comments

Cybersecurity (Anti)Patterns: Frictionware

https://spaceraccoon.dev/cybersecurity-antipatterns-frictionware/
1•crescit_eundo•23m ago•0 comments

Poison in the water: town with the worst case of PFAS contamination

https://www.theguardian.com/environment/2025/jun/19/world-worst-case-of-pfas-forever-chemicals-contamination-kallinge
2•Jimmc414•23m ago•0 comments

The lookup is coming from inside the house!

https://github.blog/security/application-security/dns-rebinding-attacks-explained-the-lookup-is-coming-from-inside-the-house/
2•crescit_eundo•23m ago•0 comments

The Smallest Aircraft Ever Made – and It Flies [video]

https://www.youtube.com/watch?v=NkGnO2erHgg
1•squircle•24m ago•0 comments

LLMs Are Weird Computers

https://www.phillipcarter.dev/posts/llms-computers
1•squircle•26m ago•0 comments

Simple Python Script for FTP Uploads

https://matduggan.com/simple-python-script-for-ftp-uploads/
1•mooreds•26m ago•0 comments

How to Make Your Developer Documentation Work with LLMs

https://fusionauth.io/blog/llms-for-docs
1•mooreds•28m ago•0 comments

Let's Get Creative: A collection of high-quality, free, online creativity tools

https://letsgetcreative.today/
1•vikrum•29m ago•0 comments

Ask HN: For a team experienced with LLMs – Any concrete reason to use LangGraph?

2•pinter69•30m ago•0 comments

Walrus Sites: Decentralised Websites

https://github.com/MystenLabs/walrus-sites
1•tzal3x•30m ago•0 comments