Secrets to Great API Design (2019)

#1

Post by spencerwgreene » Mon, Mar 14, 2022, 1:48 AM UTC

Secrets to Great API Design (2019)
nylas.com

Re: Secrets to Great API Design (2019)

#2

Post by [deleted] » Mon, Mar 14, 2022, 2:47 AM UTC

[deleted]

Re: Secrets to Great API Design (2019)

#3

Post by voicedYoda » Mon, Mar 14, 2022, 2:53 AM UTC

The article brings up interesting points, but reads like I'm blasting through a red bull ad. (Zing Zang Zoom!) API development is super important, and KIS principles should apply, but i felt this post was more marketing and less functional advice.

Re: Secrets to Great API Design (2019)

#4

Post by nerdyadventurer » Mon, Mar 14, 2022, 3:19 AM UTC

voicedYoda wrote: post #3

The article brings up interesting points, but reads like I'm blasting through a red bull ad. (Zing Zang Zoom!) API development is super important, and KIS principles should apply, but i felt this post was more marketing and less functional advice.

Any good resources on API design?

Re: Secrets to Great API Design (2019)

#5

Post by dbsmith83 » Mon, Mar 14, 2022, 3:23 AM UTC

> Learn how to make your API stand out from the rest ...

I see what did there

Re: Secrets to Great API Design (2019)

#6

Post by systemvoltage » Mon, Mar 14, 2022, 3:29 AM UTC

nerdyadventurer wrote: post #4

voicedYoda wrote: post #3

The article brings up interesting points, but reads like I'm blasting through a red bull ad. (Zing Zang Zoom!) API development is super important, and KIS principles should apply, but i felt this post was more marketing and less functional advice.

Any good resources on API design?

There was just an article on HN a couple of days ago: https://news.ycombinator.com/item?id=30647784

Comments were very insightful as always. I kind of agree with OP, this article is very thin on content and mostly peripheral take on good API design. It is unhelpful.

Re: Secrets to Great API Design (2019)

#7

Post by eyelidlessness » Mon, Mar 14, 2022, 3:59 AM UTC

nerdyadventurer wrote: post #4

voicedYoda wrote: post #3

The article brings up interesting points, but reads like I'm blasting through a red bull ad. (Zing Zang Zoom!) API development is super important, and KIS principles should apply, but i felt this post was more marketing and less functional advice.

Any good resources on API design?

Surprisingly enough (to some, including me), Microsoft's REST API design guidelines are both thorough and there's very little I'd object to.

Re: Secrets to Great API Design (2019)

#8

Post by beebmam » Mon, Mar 14, 2022, 5:01 AM UTC

eyelidlessness wrote: post #7

nerdyadventurer wrote: post #4

Earlier quoted context omitted.

Any good resources on API design?

Surprisingly enough (to some, including me), Microsoft's REST API design guidelines are both thorough and there's very little I'd object to.

There is incredibly good information on Microsoft's site for developers

Re: Secrets to Great API Design (2019)

#9

Post by BarryMilo » Mon, Mar 14, 2022, 6:13 AM UTC

beebmam wrote: post #8

eyelidlessness wrote: post #7

Earlier quoted context omitted.

Surprisingly enough (to some, including me), Microsoft's REST API design guidelines are both thorough and there's very little I'd object to.

There is incredibly good information on Microsoft's site for developers

I'm surprised anyone finds this surprising. Like them or not, Microsoft makes tight documentation for developers.

Re: Secrets to Great API Design (2019)

#10

Post by eyelidlessness » Mon, Mar 14, 2022, 6:23 AM UTC

BarryMilo wrote: post #9

beebmam wrote: post #8

Earlier quoted context omitted.

There is incredibly good information on Microsoft's site for developers

I'm surprised anyone finds this surprising. Like them or not, Microsoft makes tight documentation for developers.

I found it surprising because I interacted with their REST APIs first. They are very good about docs. The ones I use most frequently (TS) are no exception, though they have some gaps. But the actual REST APIs I integrated very clearly predate a lot of their guidelines or struggle to follow them.