API Evolution (Page 6)

Writings about API Design, OpenAPI, HTTP and related topics.

HTTP Pattern: Discovery

This type of resource is used to provide a client with the information it needs to be able to access other resources. This removes the need for a client to hardcode resource URLs which include information such as the protocol scheme, host, path and query string.

Read more...

HTTP Pattern: Progress

A progress resource is usually a temporary resource that is created automatically by the server to provide status on some long running process that has been initiated by a client. It is used to provide feedback to an end user and point to the results of an operation once it has completed.

Read more...

HTTP Pattern: Builder

A builder resource is much like a factory resource in that it is used to create another resource, however, it is a transient resource that enables idempotent creation and allows the client to specify values that cannot change over the lifetime of the created resource.

Read more...