Ask HN: What is your go-to example for a good REST API?

Re:Ask HN: What is your go-to example for a good REST API? by bparanj on Friday June 24, 2016 @05:24PM (#11973602)

-1 for Stripe. The API is designed without any thought how the use cases need to use it. Leaks the JSON structure of the document to the client. This breaks your code when they change the JSON structure.

[ Parent | on HN ]

Re:Ask HN: What is your go-to example for a good REST API? by nfm on Friday June 24, 2016 @07:24PM (#11974267)

I'm not sure what you mean about changing the JSON structure; the Stripe API is versioned and you have to opt-in to any updates, including breaking changes like removing or renaming keys in the response.

[ Parent | on HN ]

Re:Ask HN: What is your go-to example for a good REST API? by kornish on Friday June 24, 2016 @07:20PM (#11974245)

Well, all code depending on JSON presumably breaks when that JSON changes. That's what versioning is for.

What do you mean by "Leaks the JSON structure of the document to the client"?

[ Parent | on HN ]