搜索matthewbaggett 加入时间：2013年9月19日
matthewbaggett 的包
-
-
-
HTML
gone.io/zenderator
-
gone/needle
针线：一个异步 PHP 线程工作器
-
-
-
-
-
PHP
matthewbaggett/docker-api-php-client
引擎API是由Docker Engine提供的一个HTTP API。它是Docker客户端用来与引擎通信的API，因此客户端可以执行的所有操作都可以通过API完成。客户端的大部分命令直接映射到API端点（例如，`docker ps`映射为`GET /containers/json`）。值得注意的是，运行容器是由几个API调用组成的。# 错误 API使用标准的HTTP状态码来指示API调用的成功或失败。响应体将是以下格式的JSON：``` { "message": "页面未找到" } ``` # 版本控制 API通常在每个版本中都会发生变化，因此API调用都有版本号以确保客户端不会出现问题。为了锁定到API的特定版本，您需要将版本号作为URL的前缀，例如，调用`/v1.30/info`来使用`/info`端点的v1.30版本。如果URL中指定的API版本不被守护进程支持，将返回一个HTTP `400 Bad Request`错误消息。如果您省略了版本前缀，将使用当前版本的API（v1.43）。例如，调用`/info`与调用`/v1.43/info`相同。在没有版本前缀的情况下使用API已被弃用，并在未来的版本中将被删除。不久将来的引擎版本应该支持此API版本，因此即使客户端与较新的引擎通信，它也可以继续工作。API使用开放模式，这意味着服务器可能会在响应中添加额外的属性。同样，服务器将忽略任何额外的查询参数和请求体属性。当您编写客户端时，您需要忽略响应中的额外属性，以确保它们在与较新的守护进程通信时不会出现问题。# 认证 注册表的认证由客户端处理。客户端必须将认证详情发送到需要与注册表通信的各种端点，例如`POST /images/(name)/push`。这些认证详情作为`X-Registry-Auth`头部发送，格式为[base64url编码](https://tools.ietf.org/html/rfc4648#section-5)（JSON）字符串，结构如下：``` { "username": "string", "password": "string", "email": "string", "serveraddress": "string" } ``` `serveraddress`是域名/IP，不带协议。在整个结构中，必须使用双引号。如果您已经从`/auth`端点（#operation/SystemAuth）获取了身份令牌，您可以只需传递此令牌而不是凭据：``` { "identitytoken": "9cbaf023786cd7..." } ```
-
-
-