docker.io Accounts API

Get a single user

  1. GET /api/v1.1/users/:username/

获取指定用户的个人信息。

参数:

  • username – 被要求获取的用户信息的用户名。

Request Headers:

  • Authorization – required authentication credentials of either type HTTP Basic or OAuth Bearer Token.

　状态码:

  • 200 – 成功返回用户数据。
  • 401 – 权限认证错误。
  • 403 – 许可错误, 具有权限认证的用户必须是被请求的用户，OAuth access tokens 必须有 profile_read。
  • 404 – 指定的用户名不纯在。

　Example request:

  1. GET /api/v1.1/users/janedoe/ HTTP/1.1
  2. Host: www.docker.io
  3. Accept: application/json
  4. Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

Example response:

  1. HTTP/1.1 200 OK
  2. Content-Type: application/json
  4. {
  5.     "id": 2,
  6.     "username": "janedoe",
  7.     "url": "https://www.docker.io/api/v1.1/users/janedoe/",
  8.     "date_joined": "2014-02-12T17:58:01.431312Z",
  9.     "type": "User",
  10.     "full_name": "Jane Doe",
  11.     "location": "San Francisco, CA",
  12.     "company": "Success, Inc.",
  13.     "profile_url": "https://docker.io/",
  14.     "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm"
  15.     "email": "jane.doe@example.com",
  16.     "is_active": true
  17. }

Update a single user

  1. PATCH /api/v1.1/users/:username/

修改指定用户的用户信息.

参数:

  • username – username of the user whose profile info is being updated.

Json参数:

  • full_name (string) – (optional) the new name of the user.
  • location (string) – (optional) the new location.
  • company (string) – (optional) the new company of the user.
  • profile_url (string) – (optional) the new profile url.
  • gravatar_email (string) – (optional) the new Gravatar email address.

Request Headers:

  • Authorization – required authentication credentials of either type HTTP Basic or OAuth Bearer Token.
  • Content-Type – MIME Type of post data. JSON, url-encoded form data, etc.

状态码:

  • 200 – success, user data updated.
  • 400 – post data validation error.
  • 401 – authentication error.
  • 403 – permission error, authenticated user must be the user whose data is being updated, OAuth access tokens must have profile_write scope.
  • 404 – the specified username does not exist.

Example request:

  1. PATCH /api/v1.1/users/janedoe/ HTTP/1.1
  2. Host: www.docker.io
  3. Accept: application/json
  4. Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
  6. {
  7.     "location": "Private Island",
  8.     "profile_url": "http://janedoe.com/",
  9.     "company": "Retired",
  10. }

Example response:

  1. HTTP/1.1 200 OK
  2. Content-Type: application/json
  4. {
  5.     "id": 2,
  6.     "username": "janedoe",
  7.     "url": "https://www.docker.io/api/v1.1/users/janedoe/",
  8.     "date_joined": "2014-02-12T17:58:01.431312Z",
  9.     "type": "User",
  10.     "full_name": "Jane Doe",
  11.     "location": "Private Island",
  12.     "company": "Retired",
  13.     "profile_url": "http://janedoe.com/",
  14.     "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm"
  15.     "email": "jane.doe@example.com",
  16.     "is_active": true
  17. }

　列举用户的Email地址

  1. GET /api/v1.1/users/:username/emails/

List email info for the specified user.

参数:

username – username of the user whose profile info is being updated.

Request Headers:

Authorization – required authentication credentials of either type HTTP Basic or OAuth Bearer Token

状态码:

  • 200 – success, user data updated.
  • 401 – authentication error.
  • 403 – permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have email_read scope.
  • 404 – the specified username does not exist.

Example request:

  1. GET /api/v1.1/users/janedoe/emails/ HTTP/1.1
  2. Host: www.docker.io
  3. Accept: application/json
  4. Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM

Example response:

  1. HTTP/1.1 200 OK
  2. Content-Type: application/json
  4. [
  5.     {
  6.         "email": "jane.doe@example.com",
  7.         "verified": true,
  8.         "primary": true
  9.     }
  10. ]

Add email address for a user

  1. POST /api/v1.1/users/:username/emails/

Add a new email address to the specified user’s account. The email address must be verified separately, a confirmation email is not automatically sent.

Json Parameters:

email (string) – email address to be added.

Request Headers:

Authorization – required authentication credentials of either type HTTP Basic or OAuth Bearer Token. Content-Type – MIME Type of post data. JSON, url-encoded form data, etc.

状态码:

  • 201 – success, new email added.
  • 400 – data validation error.
  • 401 – authentication error.
  • 403 – permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have email_write scope.
  • 404 – the specified username does not exist.

Example request:

  1. POST /api/v1.1/users/janedoe/emails/ HTTP/1.1
  2. Host: www.docker.io
  3. Accept: application/json
  4. Content-Type: application/json
  5. Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM
  7. {
  8.     "email": "jane.doe+other@example.com"
  9. }

Example response:

  1. HTTP/1.1 201 Created
  2. Content-Type: application/json
  4. {
  5.     "email": "jane.doe+other@example.com",
  6.     "verified": false,
  7.     "primary": false
  8. }

Delete email address for a user

  1. DELETE /api/v1.1/users/:username/emails/

Delete an email address from the specified user’s account. You cannot delete a user’s primary email address.

　Json Parameters:

email (string) – email address to be deleted.

Request Headers:

Authorization – required authentication credentials of either type HTTP Basic or OAuth Bearer Token. Content-Type – MIME Type of post data. JSON, url-encoded form data, etc.

状态码:

  • 204 – success, email address removed.
  • 400 – validation error.
  • 401 – authentication error.
  • 403 – permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have email_write scope.
  • 404 – the specified username or email address does not exist.

Example request:

  1. DELETE /api/v1.1/users/janedoe/emails/ HTTP/1.1
  2. Host: www.docker.io
  3. Accept: application/json
  4. Content-Type: application/json
  5. Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM
  7. {
  8.     "email": "jane.doe+other@example.com"
  9. }

Example response:

  1. HTTP/1.1 204 NO CONTENT
  2. Content-Length: 0