Showing content from https://github.com/moby/moby/issues/5893 below:
Proposal for New and Improved Remote API · Issue #5893 · moby/moby · GitHub
The current Remote API has a number issues (#5722, #5278, #2786, #3037, #1011, #3622, #2949, etc) that make it award to use. I propose that the following issues be addressed in a new version of the API. This new API will breaking but I believe going forward the benefit of these changes will outweigh the cost IMHO.
- Change POST request that don't have payload to GET requests.
- Utilize Server-Side-Events for blocking operations and use JSON data for event data.
- Standardize error response and return a JSON object that encapsulates error messages.
- Avoid using "/json" in request URL and instead rely on "Accept" header.
- Return appropriate Content-Type header information.
- Use "camelCase" or "PascalCase" for JSON property names but not both.
- For PascalCase, two letter property names should not be capitalized (Change "ID" to "Id", and "OS" to "Os"). Doing so would make the JSON easier to process.
- Stream content type should be specific. If returning octet-stream that's a gzip file then use "application/gzip) (RFC 6713)
- Break the Remote API documentation page into smaller pages.
- Add JSON schema definitions for JSON objects.
- Add HATEOAS support?
I have started a new repository wiki page to track this proposal. I have also done a first take on revamping the List Containers request and would love feedback.
https://github.com/saden1/docker-api/wiki/List-Containers
Is this something the docker team is interested in doing?
RetroSearch is an open source project built by @garambo
| Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4