liveBook · Manning

Resource

An API resource is a named, addressable conceptual entity exposed by an interface for access or manipulation.

How 3 Manning books explain it

The Design of Web APIs, Second Edition

A product resource is an API-represented product entity that can be addressed or manipulated by operations.

How it is used
Identifies the business concept each REST API operation manipulates before that operation is represented with HTTP.
How deep it goes
Defines resource independence and gives procedures for finding targets and relationships, then defers paths and fine-grained data modeling.
Examples
Uses Product and Catalog operations, a merchant’s catalog, and course-platform exercises to test resource identification.
What you can do after
Practice/perform resource identification from operation descriptions and outcomes, then distinguish elements from containers before mapping them to HTTP.

Read how The Design of Web APIs, Second Edition explains resource →

API Design Patterns

An API resource is a named conceptual entity that the API stores, exposes, or allows clients to manipulate.

How it is used
Standardizes API design around a limited set of named things and recurring actions.
How deep it goes
Defines resources, maps them to standard lifecycle methods, and explains scope decisions without detailing implementation internals.
Examples
Uses flight reservations, image annotations, bounding boxes, notes, messages, books, authors, and change-log entries.
What you can do after
Designs resource-oriented APIs with consistent operations, appropriate scope, and clear collection-versus-resource targets.

Read how API Design Patterns explains resource →

Kubernetes in Action, Second Edition

An API resource is an addressable Kubernetes API endpoint and representation associated with an object type.

How it is used
Structures Kubernetes cluster interaction around addressable representations manipulated through REST operations.
How deep it goes
Explains URIs, collections, instances, CRUD methods, and object relationships, then connects resources to manifests, status, and controllers.
Examples
Uses deployment collection and instance URIs, YAML or JSON manifests, GET and PUT requests, and API events.
What you can do after
Operate/configure Kubernetes objects by addressing resources, posting manifests, retrieving status, and interpreting events.

Read how Kubernetes in Action, Second Edition explains resource →

Also covered in

What to know first

Related concepts

Questions about resource

What is resource?

An API resource is a named, addressable conceptual entity exposed by an interface for access or manipulation.

Which Manning books explain resource?

The Design of Web APIs, Second Edition, API Design Patterns and Kubernetes in Action, Second Edition.

What should I know before learning resource?

Manning books that teach resource usually introduce HTTP, REST, HTTP method and JSON first.

What kinds of resource are there?

Kinds of resource include job, action resource and action result.

What is resource a kind of?

Resource is a kind of domain concept. A domain concept is an idea, entity, action, rule, or other meaningful element of a problem or business domain represented in software.

What are the parts of resource?

Resource includes attribute.

These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.