General considerations on API design
We choose to adopt three general principles. Here’s a shortcut to remember: RESTful, Hypermedia, Fine-grained
|API and domain modelling|
Resource Oriented Design
This Design Guide explains how to apply REST principles to API designs independent of programming language, operating system, or network protocol. It is NOT a guide solely to creating REST APIs.
|What is a REST API?|
The Design Guide suggests taking the following steps when designing resource- oriented APIs