REST and Hypermedia
- 1 External
- 2 Internal
- 3 API
- 4 Endpoint
- 5 Resource
- 6 Method
- 7 HTTP Protocol Semantics within a REST Application Context
- 8 Representation
- 9 Universal Resource Locator (URL)
- 10 Universal Resource Identifier (URI)
- 11 Representational State Transfer (REST)
- 12 Multipurpose Internet Mail Extension (MIME)
- 13 Media Type
Also referred to as "path variable".
A method corresponds to a REST API request that is submitted by the user of the API to a resource and to the response returned to the user. Methods belong to resources, and are defined by combinations of resource paths and operations. The API methods represent the programming interface between the client and the API.
A Method Request is part of the API's interface with the API's client.
A Method Response is part of the API's interface with the API's client.
HTTP Protocol Semantics within a REST Application Context
A resource's operations are defined by HTTP verbs:
Destroy the resource.
Defined in RFC 5789.
Modifies part of the state of the given resource based on the given representation. If some bit of resource state is not mentioned in the representation, it should be left unmodified. PATCH is like PUT, but allows for fine-grained changes in resource state.
Discover which methods this resource responds to. This method is mostly used when a client explores the API.
Universal Resource Locator (URL)
Universal Resource Locator
Universal Resource Identifier (URI)
Universal Resource Identifier
Representational State Transfer (REST)
RWA page 32
Multipurpose Internet Mail Extension (MIME)
MIME is an internet standard that extends the format of e-mail to support text in character sets other then ASCII, non-text attachments, such as audio, video, images, application programs, etc., message bodies with multiple parts and header information in non-ASCII characters sets. MIME is specified in six linked RFCs: RFC 2045, RFC 2046, RFC 2047, RFC 4288, RFC 4289 and RFC 2049.
MIME is relevant to HTTP. The content types define by MIME are used in the definition of HTTP content. HTTP clients use MIME content type headers to indicate the desired application to process the specific type of content they send. HTTP servers insert MIME content type information in all their responses.
MIME defines the following headers:
A media type, also called media-type, content type or MIME type is a two-part string identifying the format of a document. Usually, knowing a document's format allows us to parse it. IANA (Internet Assigned Numbers Authority) is the official authority for the standardization and publication of media types.
The media type string consists of a type and a subtype. The subtype can be further be structured into a tree. A media type can optionally define a suffix and parameters:
type "/" [tree "." ] subtype ["+" suffix] *[";" parameter]
The currently registered types are: "application", "audio", "example", "font", "image", "message", "model", "multipart", "text" and "video".
An HTML file may be designated as: