As described in Spreadshirt API v1 Explained, the Spreadshirt Data and Image API is provided as a RESTful (Representational State Transfer) API via HTTP, which means that we use HTTP methods, HTTP status codes, URL structures and the concepts of resource and representation correctly to allow API clients to retrieve, create, update and delete data and images.
The Wikipedia article about REST (Representational State Transfer) describes the REST-style architecture and the concept of resource and representation as follows: “REST-style architectures consist of clients and servers. Clients initiate requests to servers; servers process requests and return appropriate responses. Requests and responses are built around the transfer of representations of resources. A resource can be essentially any coherent and meaningful concept that may be addressed. A representation of a resource is typically a document that captures the current or intended state of a resource.” The section on RESTful web services in the Wikipedia article also describes the proposed URL structures and usage of HTTP methods for what is called collections and elements in the article. Continue reading “Resource Types supported by Spreadshirt API v1”