REST API Guidelines¶

| api | rest |

REST API is the most popular interface for communication between different component of the system. There are a lot of different common sense approaches to design RESTful API. Despite this fact it is always better to have something written as a reference to follow common principles during API design of the system.

Here I have collected some REST API guidelines and API References. It’s nice start point for your inspiration.

REST API Guidelines¶

• Microsoft - REST API Guidelines
• Microsoft - Best Practices - API Design
• Zalando - REST API Guidelines
• Paypal - REST API Guidelines
• Atlassian - REST API design guidelines version 1
• Digital Ocean - API v2 Introduction
• Google Cloud Platform - API Design Guide
• Red Hat Lessons learnt from designing the Red Hat Enterprise Virtualization API
• Australian Government Agencies - AusDTO API Design Guide
• Cloud Foundry - Cloud Controller API v3 Style Guide (Proposal)
• Heroku - API Design Guide
• A RESTful Tutorial

Sample APIs¶

• GitHub REST API v3
• Twitter API
• Google Drive APIs
• Trello API
• Stack Exchange API v2.2
• Jira API
• Stripe API
• Heroku API
• Travis CI API

Also, Apigee provides huge list of different API providers in one place: https://apigee.com/providers