HN Explorer

Searching for a Well Designed API

1 points by willx86 ↗ HN
Hihi I'm looking for an example of a well designed api that's a small scope, a lot of places I've tried to learn from are such monoliths that where to start is daunting

Preferrably an open source project

I'd prefer: REST/gRPC/ contained and hopefully not something huge Go/Rust/Python/js-ts ( in that order!!)

Apologies if this is the wrong place to ask! Thank you

5 comments

[ 35.0 ms ] story [ 140 ms ] thread
willx86
This is primarily to try and learn from, I should've made this a bit clearer.
austin-cheney
I manage 40% of a major enterprise API effort for the government. At work we use RAML to design and specify our APIs and they are all REST. The actual API requirements come from existing data systems or external teams.

For my personal software I design all my APIs as JSON objects, using TypeScript interfaces for their definitions, and I associate those objects to a service name. So data will look like a parent object with properties data and service where data is the defined JSON payload and service is the name of that data schema. This allows me to use a WebSocket connection for all my various services and it’s so much faster.

willx86
Very interesting thank you :)