Live data from Hacker News

Searching for a Well Designed API

news.ycombinator.com

1–6 of 6 posts

Searching for a Well Designed API

#1
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

Re: Searching for a Well Designed API

#3
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.

Re: Searching for a Well Designed API

#6

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…

Very interesting thank you :)