docker.io アカウント API

ユーザ情報を取得

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

特定のユーザに関するプロフィールを取得します。

パラメータ:

  • username … リクエスト対象のユーザのユーザ名

リクエスト・ヘッダ:

  • Authorization … 認証のために必要となる HTTP Basic 認証の情報か OAuth Bearer トークン

ステータス・コード:

  • 200 … 成功。ユーザのデータを返す
  • 401 … 認証エラー
  • 403 … 権限エラー。リクエストのためには適切な認証データが必要。Oauth アクセス・トークンの場合は profile_read スコープが必要
  • 404 … 指定したユーザ名が存在しない

リクエスト例

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

応答例

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 2,
    "username": "janedoe",
    "url": "https://www.docker.io/api/v1.1/users/janedoe/",
    "date_joined": "2014-02-12T17:58:01.431312Z",
    "type": "User",
    "full_name": "Jane Doe",
    "location": "San Francisco, CA",
    "company": "Success, Inc.",
    "profile_url": "https://docker.io/",
    "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm"
    "email": "jane.doe@example.com",
    "is_active": true
}
PATCH /api/v1.1/users/:username/

特定のユーザのプロフィール情報を更新します。

パラメータ:

  • username … プロフィールを更新するユーザのユーザ名

JSON パラメータ:

  • full_name (文字列) … (オプション)ユーザの新しい名前
  • location (文字列) … (オプション)新しい場所
  • company (文字列) … (オプション)ユーザの新しい会社
  • profile_url (文字列) … (オプション)新しいプロフィール URL
  • gravatar_email (文字列) … (オプション)新しい Gravatar メールアドレス

リクエスト・ヘッダ:

  • Authorization … 認証のために必要となる HTTP Basic 認証の情報か OAuth Bearer トークン
  • Content-Type … JSON、 url エンコード形式のデータ等、ポストする MIME タイプ

ステータス・コード:

  • 200 … 成功。ユーザのデータを返す
  • 400 … POST するデータ形式が無効
  • 401 … 認証エラー
  • 403 … 権限エラー。リクエストのためには適切な認証データが必要。Oauth アクセス・トークンの場合は profile_read スコープが必要
  • 404 … 指定したユーザ名が存在しない

リクエスト例

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

{
    "location": "Private Island",
    "profile_url": "http://janedoe.com/",
    "company": "Retired",
}

応答例

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 2,
    "username": "janedoe",
    "url": "https://www.docker.io/api/v1.1/users/janedoe/",
    "date_joined": "2014-02-12T17:58:01.431312Z",
    "type": "User",
    "full_name": "Jane Doe",
    "location": "Private Island",
    "company": "Retired",
    "profile_url": "http://janedoe.com/",
    "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm"
    "email": "jane.doe@example.com",
    "is_active": true
}

ユーザのメールアドレス一覧

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

特定のユーザのメール情報一覧を表示。

  • username … メール情報を表示したいユーザのユーザ名

リクエスト・ヘッダ:

  • Authorization … 認証のために必要となる HTTP Basic 認証の情報か OAuth Bearer トークン

ステータス・コード:

  • 200 … 成功。ユーザのデータを返す
  • 401 … 認証エラー
  • 403 … 権限エラー。リクエストのためには適切な認証データが必要。Oauth アクセス・トークンの場合は profile_read スコープが必要
  • 404 … 指定したユーザ名が存在しない

リクエスト例

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

応答例

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "email": "jane.doe@example.com",
        "verified": true,
        "primary": true
    }
]

ユーザにメールアドレスを追加

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

特定のユーザ・アカウントに対して新しいメールアドレスを追加します。メールアドレスは個々に確認されたものであるとし、確認用のメールは自動的に送信されません。

JSON パラメータ:

  • email (文字列) … メールアドレスが追加されます。

リクエスト・ヘッダ:

  • Authorization … 認証のために必要となる HTTP Basic 認証の情報か OAuth Bearer トークン
  • Content-Type … JSON、 url エンコード形式のデータ等、ポストする MIME タイプ

ステータス・コード:

  • 200 … 成功。ユーザのデータを返す
  • 400 … POST するデータ形式が無効
  • 401 … 認証エラー
  • 403 … 権限エラー。リクエストのためには適切な認証データが必要。Oauth アクセス・トークンの場合は profile_read スコープが必要
  • 404 … 指定したユーザ名が存在しない。

リクエスト例

POST /api/v1.1/users/janedoe/emails/ HTTP/1.1
Host: www.docker.io
Accept: application/json
Content-Type: application/json
Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM

{
    "email": "jane.doe+other@example.com"
}

応答例

HTTP/1.1 201 Created
Content-Type: application/json

{
    "email": "jane.doe+other@example.com",
    "verified": false,
    "primary": false
}

ユーザのメールアドレスを削除

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

特定のユーザ・アカウントに登録されているメールアドレスを削除します。ユーザのプライマリ・メールアドレスは削除できません。

JSON パラメータ:

  • email (文字列) … メールアドレスが追加されます。

リクエスト・ヘッダ:

  • Authorization … 認証のために必要となる HTTP Basic 認証の情報か OAuth Bearer トークン
  • Content-Type … JSON、 url エンコード形式のデータ等、ポストする MIME タイプ

ステータス・コード:

  • 200 … 成功。ユーザのデータを返す
  • 400 … POST するデータ形式が無効
  • 401 … 認証エラー
  • 403 … 権限エラー。リクエストのためには適切な認証データが必要。Oauth アクセス・トークンの場合は profile_read スコープが必要
  • 404 … 指定したユーザ名が存在しない。

リクエスト例

DELETE /api/v1.1/users/janedoe/emails/ HTTP/1.1
Host: www.docker.io
Accept: application/json
Content-Type: application/json
Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM

{
    "email": "jane.doe+other@example.com"
}

応答例

HTTP/1.1 204 NO CONTENT
Content-Length: 0