API design concerns
The APIs are meant to be consumed and define how the API can be consumed. APIs specify the list of commands/operations as well as the format/schema of those commands that are required for interaction with the API.
When defining a REST API, the key abstraction of information is the resource. A resource is defined as a conceptual mapping to a set of entities. API design is centered around the resource that forms the nucleus of the design. Uniform Resource Identifier (URI), operations (using HTTP methods), and resource representations (JSON schema) are built keeping the resource in mind. It becomes very important to have the right abstraction of the resource to enable consumption, re-usability, and maintainability of the ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access