Resource
An API resource is a named, addressable conceptual entity exposed by an interface for access or manipulation.
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.
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
- HTTPHTTP is an application-layer protocol that defines request-and-response communication for transferring resource representations and related metadata between networked systems.
- RESTREST is an architectural style for distributed systems that organizes interactions around identifiable resources and their representations, using a uniform interface and constraints such as statelessness and cacheability.
- HTTP methodAn HTTP method is a standardized token in an HTTP request that indicates the operation the client intends to perform on a resource.
- JSONJSON is a language-independent text-based data-interchange format that represents structured values using objects, arrays, strings, numbers, booleans, and null.
Related concepts
- jobincludes · A Kubernetes Job is a workload resource that runs Pods for a finite task and tracks execution until the required successful completions are reached.
- attributehas part · An attribute is a named property or piece of information associated with an entity, object, or structured data item.
- action resourceincludes · An action resource is a REST API resource that represents an executable process or action rather than a persistent business entity.
- action resultincludes · An action result is the response or outcome produced by an API or MVC action when handling a request.
- domain conceptkind of · A domain concept is an idea, entity, action, rule, or other meaningful element of a problem or business domain represented in software.
- objectkind of · An object is a distinct entity represented or manipulated within a computational system, typically as a value, data structure, resource, or instance of a type.
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.


