3 ms·
Not on a technical slant, but here is a good, pragmatic API design guide by Vinay Sahni that I came across a couple of years back [0]. It gave me a ton of good
by cyberferret 9y ago
Not on a technical slant, but here is a good, pragmatic API design guide by Vinay Sahni that I came across a couple of years back [0]. It gave me a ton of good ideas on how to design the API for our SaaS app.
[0] - http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...
- aivarsk 9y agoI quickly looked at it and "don't use envelopes by default", "paginate using Link headers" contradict what http://jsonapi.org/ http://jsonapi.org/ specification says. json:api might not be the best standard and there might be better ones but using something that has many implementations in different languages is better that rolling your own.
- ecaradec 9y agoI used Vinai guide and these exact two advices caused issues as the api grow.