Best Practices for Designing a Pragmatic RESTful API

Click for: original source

Vinay Sahni - Founder of Enchant and Full stack developer - shares his experience with designing RESTful API. He tried to come up with pragmatic answers to hard questions so final API is easy to use, easy to adopt and flexible enough to dogfood for our own user interfaces.

Articles lists zillion of carefully selected resources to help you follow recommended practices when it makes sense and to help you guide decision making process.

What you learn

  • It helps you with identification of key requirements for the API
  • Explains RESTful URLs and actions, e.g.separating your API into logical resource
  • How you deal with relations
  • Mentions importance of SSL** etc.
  • An API is only as good as its documentation.
  • Do not forget to version your API - always.

Well worth your time.

[Read More]

Tags apis software-architecture