イベントペイロード

GDPR 規制に従ってユーザーのプライバシーを向上させるため、Bitbucket やその他の Atlassian Cloud 製品では個人データへのアクセスの管理方法を統一するために製品 API の更新を進めています。これらの API の変更は、アトラシアン製品で今後予定されている改善である、データの表示およびアクセスを許可するユーザーのより詳細な制御をサポートするために必要です。

username エンドポイントと username フィールドの提供は 2019 年 4 月 12 日に廃止する予定です。アトラシアンではこれらを置き換えるため、すぐに使用できる複数の新しいデータポイントを導入します。詳細は、API の廃止のお知らせを参照してください。

イベントに関連付けられた Webhook がある場合、Bitbucket はイベントが発生するたびに Webhook のサーバー URL にイベントリクエストを送信します。このページでは、これらのリクエストの構造について説明します。

HTTPS エンドポイントに関連付けられた Webhook のイベントペイロードリクエストを Bitbucket が送信する場合、URL に公的な認証局が署名した有効な SSL 証明書があることを確認してください。

また、許可リストに追加する Bitbucket Cloud IP アドレスもご確認ください。

次のペイロードには、5 つの一般的なエンティティタイプである Account、Repository、Issue、Comment、Pull Request の一部が含まれています。これらは、ペイロードが表示されるすべての場所で一貫して表示されます。たとえば、 repo:push ペイロードの actor プロパティはイベントのユーザーを表します。共通エンティティセクションには、これらのエンティティの例が記載されています。

HTTP ヘッダー

すべてのイベントペイロードには次の HTTP ヘッダーがあります。

HTTP ヘッダー	説明
`X-Event-Key`	Webhook をトリガーするイベントのイベントキー (例: `repo:push`)。
`X-Hook-UUID`	イベントがトリガーする Webhook の UUID。Webhook の UUID の詳細については、「Webhook リソース」を参照してください。
`X-Request-UUID`	リクエストの UUID。
`X-Attempt-Number`	Bitbucket がペイロードの送信を試みた回数。最初のリクエストの後、以前の試行が失敗した場合、Bitbucket はさらに 2 回ペイロードの送信を試みます。

リポジトリイベント

リポジトリで発生する次のイベント用に Webhook を作成できます。

プッシュ

ユーザーは 1 つ以上のコミットをリポジトリにプッシュします。このペイロードには repo:push のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	コミットをプッシュしたユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	コミットがあるリポジトリ。`Repository` エンティティの例を参照してください。
`push`	プッシュの詳細 (`changes` プロパティを含む)。このプロパティには、プッシュが更新したすべての references を含む配列と、次のプロパティが含まれます。 `new`: プッシュ後の参照状態に関する情報を含むオブジェクト。ブランチが削除されると、`new` は `null` になります。`new` には以下のプロパティが含まれます。 `type`: 変更の参照タイプ。 Git リポジトリの `branch`、または `tag`。 Mercurial リポジトリの `named_branch`、`bookmark`、または `tag`。 `name`: ブランチ、タグ、名前付きブランチ、またはブックマークの名前。 `target`: プッシュ後の最新のコミットの詳細。 `links`: API (`self` および `commits`) および Bitbucket (`html`) のリファレンスへのリンク。 `old`: プッシュ前のリファレンスの状態に関する情報を含むオブジェクト。ブランチが作成されると、old は `null` になります。`old` には以下のプロパティが含まれます。 `type`: 変更の参照タイプ: Git リポジトリの `branch`、`tag`、または `annotated_tag`。 Mercurial リポジトリの `named_branch` または `bookmark`。 `name`: ブランチ、タグ、名前付きブランチ、またはブックマークの名前。 `target`: プッシュ前の最新のコミットの詳細。 `links`: API (`self` および `commits`) および Bitbucket (`html`) のリファレンスへのリンク。 `links` : Bitbucket (`html`)、API (`commits`)、および diff 形式 (`diff`) の変更へのリンク。 `created`: `true` または `false`。リファレンスが新しいかどうかを示します。 `closed`: `true` または `false`。リファレンスが古いかどうかを示します。 `forced`: `true` または `false`。プッシュが強制されたかどうかを示します。 `commits`: そのリファレンスにプッシュされた最新のコミット (最大 5 つ) を含む配列。コミットが 5 件よりも多いプッシュの配列は切り捨てられ、`truncated` プロパティで示されます。配列には、新しいコミットに加えて次のコミットも含まれる場合があります。このリファレンスにプッシュされていないコミット – リファレンスが最近作成された場合、リポジトリへプッシュされてもこの特定のリファレンスにはプッシュされていないコミットがある可能性があります。その場合、配列には以前プッシュしたコミットも含まれます。たとえば、多数のコミットがある main ブランチから新しい feature ブランチを作成してそこに 1 件のコミットをプッシュすると、ペイロードの配列には 5 件のコミット (すべてがその feature ブランチにとって新しいコミット) が含まれます。これらのコミットには、先ほど行った 1 つのコミットと main ブランチの最新コミット 4 件が含まれます。強制的にプッシュされたコミット - リベースの後に強制プッシュを実行すると、古いリファレンスのコミットは新しいリファレンス内のすべてのコミットに置き換えられます。その結果、配列には新しいリファレンスのコミット部分が含まれるようになります。配列には、リベースまたは強制プッシュの際に削除されたコミットは含まれません。 `truncated`: `true` または `false`。Bitbucket がこのペイロードの `commits` 配列を切り捨てたかどうかを表示します。5 件よりも多くのコミットがプッシュされると、配列は切り捨てられます。その場合、`commits` 配列には、最新 5 件のコミットのみが含まれます。

パラメーター

説明

actor

コミットをプッシュしたユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

repository

コミットがあるリポジトリ。Repository エンティティの例を参照してください。

push

プッシュの詳細 (changes プロパティを含む)。このプロパティには、プッシュが更新したすべての references を含む配列と、次のプロパティが含まれます。

new: プッシュ後の参照状態に関する情報を含むオブジェクト。ブランチが削除されると、new は null になります。new には以下のプロパティが含まれます。
- type: 変更の参照タイプ。
  - Git リポジトリの branch、または tag。
  - Mercurial リポジトリの named_branch、bookmark、または tag。
- name: ブランチ、タグ、名前付きブランチ、またはブックマークの名前。
- target: プッシュ後の最新のコミットの詳細。
- links: API (self および commits) および Bitbucket (html) のリファレンスへのリンク。
old: プッシュ前のリファレンスの状態に関する情報を含むオブジェクト。ブランチが作成されると、old は null になります。old には以下のプロパティが含まれます。
- type: 変更の参照タイプ:
  - Git リポジトリの branch、tag、または annotated_tag。
  - Mercurial リポジトリの named_branch または bookmark。
- name: ブランチ、タグ、名前付きブランチ、またはブックマークの名前。
- target: プッシュ前の最新のコミットの詳細。
- links: API (self および commits) および Bitbucket (html) のリファレンスへのリンク。
links : Bitbucket (html)、API (commits)、および diff 形式 (diff) の変更へのリンク。
created: true または false。リファレンスが新しいかどうかを示します。
closed: true または false。リファレンスが古いかどうかを示します。
forced: true または false。プッシュが強制されたかどうかを示します。
commits: そのリファレンスにプッシュされた最新のコミット (最大 5 つ) を含む配列。コミットが 5 件よりも多いプッシュの配列は切り捨てられ、truncated プロパティで示されます。配列には、新しいコミットに加えて次のコミットも含まれる場合があります。
- このリファレンスにプッシュされていないコミット – リファレンスが最近作成された場合、リポジトリへプッシュされてもこの特定のリファレンスにはプッシュされていないコミットがある可能性があります。その場合、配列には以前プッシュしたコミットも含まれます。たとえば、多数のコミットがある main ブランチから新しい feature ブランチを作成してそこに 1 件のコミットをプッシュすると、ペイロードの配列には 5 件のコミット (すべてがその feature ブランチにとって新しいコミット) が含まれます。これらのコミットには、先ほど行った 1 つのコミットと main ブランチの最新コミット 4 件が含まれます。
- 強制的にプッシュされたコミット - リベースの後に強制プッシュを実行すると、古いリファレンスのコミットは新しいリファレンス内のすべてのコミットに置き換えられます。その結果、配列には新しいリファレンスのコミット部分が含まれるようになります。配列には、リベースまたは強制プッシュの際に削除されたコミットは含まれません。
truncated: true または false。Bitbucket がこのペイロードの commits 配列を切り捨てたかどうかを表示します。5 件よりも多くのコミットがプッシュされると、配列は切り捨てられます。その場合、commits 配列には、最新 5 件のコミットのみが含まれます。

repo:push payload

{    
  "actor": Account,
  "repository": Repository,
  "push": {
    "changes": [
      {
        "new": {
          "type": "branch",
          "name": "name-of-branch",
          "target": {
            "type": "commit",
            "hash": "709d658dc5b6d6afcd46049c2f332ee3f515a67d",
            "author": User,
            "message": "new commit message\n",
            "date": "2015-06-09T03:34:49+00:00",
            "parents": [
              {
                "type": "commit",
                "hash": "1e65c05c1d5171631d92438a13901ca7dae9618c",
                "links": {
                  "self": {
                    "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commit/8cbbd65829c7ad834a97841e0defc965718036a0"
                  },
                  "html": {
                    "href": "https://bitbucket.org/user_name/repo_name/commits/8cbbd65829c7ad834a97841e0defc965718036a0"
                  }
                }
              }
            ],
            "links": {
              "self": {
                "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commit/c4b2b7914156a878aa7c9da452a09fb50c2091f2"
              },
              "html": {
                "href": "https://bitbucket.org/user_name/repo_name/commits/c4b2b7914156a878aa7c9da452a09fb50c2091f2"
              }
            }
          },
          "links": {
            "self": {
              "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/refs/branches/main"
            },
            "commits": {
              "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commits/main"
            },
            "html": {
              "href": "https://bitbucket.org/user_name/repo_name/branch/main"
            }
          }
        },
        "old": {
          "type": "branch",
          "name": "name-of-branch",
          "target": {
            "type": "commit",
            "hash": "1e65c05c1d5171631d92438a13901ca7dae9618c",
            "author": User,
            "message": "old commit message\n",
            "date": "2015-06-08T21:34:56+00:00",
            "parents": [
              {
                "type": "commit",
                "hash": "e0d0c2041e09746be5ce4b55067d5a8e3098c843",
                "links": {
                  "self": {
                    "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commit/9c4a3452da3bc4f37af5a6bb9c784246f44406f7"
                  },
                  "html": {
                    "href": "https://bitbucket.org/user_name/repo_name/commits/9c4a3452da3bc4f37af5a6bb9c784246f44406f7"
                  }
                }
              }
            ],
            "links": {
              "self": {
                "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commit/b99ea6dad8f416e57c5ca78c1ccef590600d841b"
              },
              "html": {
                "href": "https://bitbucket.org/user_name/repo_name/commits/b99ea6dad8f416e57c5ca78c1ccef590600d841b"
              }
            }
          },
          "links": {
            "self": {
              "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/refs/branches/main"
            },
            "commits": {
              "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commits/main"
            },
            "html": {
              "href": "https://bitbucket.org/user_name/repo_name/branch/main"
            }
          }
        },
        "links": {
          "html": {
            "href": "https://bitbucket.org/user_name/repo_name/branches/compare/c4b2b7914156a878aa7c9da452a09fb50c2091f2..b99ea6dad8f416e57c5ca78c1ccef590600d841b"
          },
          "diff": {
            "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/diff/c4b2b7914156a878aa7c9da452a09fb50c2091f2..b99ea6dad8f416e57c5ca78c1ccef590600d841b"
          },
          "commits": {
            "href": "https://api.bitbucket.org/2.0/repositories/user_name/repo_name/commits?include=c4b2b7914156a878aa7c9da452a09fb50c2091f2&exclude=b99ea6dad8f416e57c5ca78c1ccef590600d841b"
          }
        },
        "created": false,
        "forced": false,
        "closed": false,
        "commits": [

          {

            "hash": "03f4a7270240708834de475bcf21532d6134777e",

            "type": "commit",

            "message": "commit message\n",

            "author": Account,

            "links": {

              "self": {

                "href": "https://api.bitbucket.org/2.0/repositories/user/repo/commit/03f4a7270240708834de475bcf21532d6134777e"

              },

              "html": {

                "href": "https://bitbucket.org/user/repo/commits/03f4a7270240708834de475bcf21532d6134777e"

              }

            }

          }

        ],

        "truncated": false

      }
    ]
  }
}

フォーク

ユーザーはリポジトリをフォークします。このペイロードには repo:fork のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	リポジトリをフォークするユーザー。このユーザーはフォークの所有者でもあります。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	フォークされた元のリポジトリ。`Repository` エンティティの例を参照してください。
`fork`	フォークの結果として生成された新しいリポジトリ。`Repository` エンティティの例を参照してください。

パラメーター

説明

actor

リポジトリをフォークするユーザー。このユーザーはフォークの所有者でもあります。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

repository

フォークされた元のリポジトリ。Repository エンティティの例を参照してください。

fork

フォークの結果として生成された新しいリポジトリ。Repository エンティティの例を参照してください。

repo:fork

{
  "actor": Account,
  "repository": Repository,
  "fork": Repository
}

更新日

A user updates the Name, Description, Website, or Language fields under the Repository details page of the repository settings. This payload, with an event key of repo:updated , provides the following fields:

パラメーター	説明
`actor`	更新を行ったユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	更新されたリポジトリ。`Repository` エンティティの例を参照してください。
`changes`	変更の詳細 (新しい設定と以前の設定内容を含む)。ペイロードには、値が変更されたプロパティのみが含まれます。 `name`: The `new` Name of the repository and its `old` name. `website`: The `new` Website for the repository and its `old` website. `language`: The `new` Language for the repository and its `old` language. `links`: リポジトリのアバター (`avatar`)、API のリポジトリ (`self`)、および Bitbucket のリポジトリ (`html`) の新しい (`new`) リンクと古い (`old`) リンク。 `description`: The `new` Description of the repository and its `old` description. `full_name`: リポジトリの新しい (`new`) フルネームと古い (`old`) フルネーム。これには、チームまたはユーザーのアカウント名、スラッシュ (/)、およびリポジトリ名が含まれます。

パラメーター

説明

actor

更新を行ったユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

repository

更新されたリポジトリ。Repository エンティティの例を参照してください。

changes

変更の詳細 (新しい設定と以前の設定内容を含む)。ペイロードには、値が変更されたプロパティのみが含まれます。

name: The new Name of the repository and its old name.
website: The new Website for the repository and its old website.
language: The new Language for the repository and its old language.
links: リポジトリのアバター (avatar)、API のリポジトリ (self)、および Bitbucket のリポジトリ (html) の新しい (new) リンクと古い (old) リンク。
description: The new Description of the repository and its old description.
full_name: リポジトリの新しい (new) フルネームと古い (old) フルネーム。これには、チームまたはユーザーのアカウント名、スラッシュ (/)、およびリポジトリ名が含まれます。

repo:updated payload

{
  "actor": Account,
  "repository": Repository,
  "changes": {
    "name": {
"new": "repository",
      "old": "repository_name"
    }
    "website": {
      "new": "http://www.example.com/",
      "old": ""
    }
    "language": {
      "new": "java",
      "old": ""
    }
    "links": {
      "new": {
        "avatar": {
          "href": "https://bitbucket.org/teamawesome/repository/avatar/32/"
        },
        "self": {
          "href": "https://api.bitbucket.org/2.0/repositories/teamawesome/repository"
        }
        "html": {
          "href": "https://bitbucket.org/teamawesome/repository"
        }
      },
      "old": {
        "avatar": {
          "href": "https://bitbucket.org/teamawesome/repository_name/avatar/32/"
        },
        "self": {
          "href": "https://api.bitbucket.org/2.0/repositories/teamawesome/repository_name"
        },
        "html": {
          "href": "https://bitbucket.org/teamawesome/repository_name"
        }
      }
    },
    "description": {
      "new": "This is a better description.",
      "old": "This is a description."
    }
    "full_name": {
      "new": "teamawesome/repository",
      "old": "teamawesome/repository_name"
    }
  }
}

転送

リポジトリの譲渡が許可されます。これには repo:transfer のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	リポジトリを譲渡したユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	譲渡されたリポジトリ。`Repository` エンティティの例を参照してください。
`previous_workspace`	リポジトリの以前のコンテナー。`Workspace` エンティティの例を参照してください。

パラメーター

説明

actor

リポジトリを譲渡したユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

repository

譲渡されたリポジトリ。Repository エンティティの例を参照してください。

previous_workspace

リポジトリの以前のコンテナー。Workspace エンティティの例を参照してください。

repo:transfer ペイロード

{
  "actor": Account,
  "repository": Repository,
  "previous_workspace": Workspace
 }     

作成したコメントのコミット

ユーザーはリポジトリのコミットにコメントを追加します。このペイロードには repo:commit_comment_created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	コミットにコメントを追加したユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`comment`	作成されたコメント。`Comment` エンティティの例を参照してください。
`repository`	コミットがあるリポジトリ。`Repository` エンティティの例を参照してください。
`commit`	コミットの詳細 (ハッシュを含む)。

repo:commit_comment_created ペイロード

{
  "actor": Account,
  "comment": Comment,
  "repository": Repository,
  "commit": {
    "hash": "d3022fc0ca3d65c7f6654eea129d6bf0cf0ee08e"
  }
}

ビルドステータスの作成

ビルドシステム、CI ツール、または別のベンダーでは、ユーザーによるコミットのプッシュを認識し、コミットをそのステータスで更新します。このペイロードには repo:commit_status_created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	コミットステータスを作成したユーザー。Bitbucket Connect アプリの場合は、アプリが代理として機能するワークスペースユーザーです。 `User` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	コミットがあるリポジトリ。`Repository` エンティティの例を参照してください。
`commit_status`	コミットステータスの詳細。次のプロパティが含まれています。 `name`: コミットステータスの名前。 `description`: コミットステータスの説明。 `state`: コミットステータス。`INPROGRESS`、`SUCCESSFUL`、または `FAILED` のいずれかです。 `key`: ステータスを同じコミットに関連付けられた他のステータスと識別するためにシステムまたはベンダーが提供するキー。 `url`: ステータスを生成するベンダーまたはシステムへの URL。 `type`: コミットステータスのタイプ。現時点では、Bitbucket はコミットステータスをビルドと関連付けることのみ可能です。したがって、サポートされているタイプは `build` のみです。 `created_on`: コミットステータスが作成された日時 (ISO 8601 フォーマット)。 `updated_on`: コミットステータスが最後に更新された日時 (ISO 8601 フォーマット)。 `links`: API または Bitbucket でのコミットおよびコミットステータスの表現へのリンク。

パラメーター

説明

actor

コミットステータスを作成したユーザー。Bitbucket Connect アプリの場合は、アプリが代理として機能するワークスペースユーザーです。

User エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

repository

コミットがあるリポジトリ。Repository エンティティの例を参照してください。

commit_status

コミットステータスの詳細。次のプロパティが含まれています。

name: コミットステータスの名前。
description: コミットステータスの説明。
state: コミットステータス。INPROGRESS、SUCCESSFUL、または FAILED のいずれかです。
key: ステータスを同じコミットに関連付けられた他のステータスと識別するためにシステムまたはベンダーが提供するキー。
url: ステータスを生成するベンダーまたはシステムへの URL。
type: コミットステータスのタイプ。現時点では、Bitbucket はコミットステータスをビルドと関連付けることのみ可能です。したがって、サポートされているタイプは build のみです。
created_on: コミットステータスが作成された日時 (ISO 8601 フォーマット)。
updated_on: コミットステータスが最後に更新された日時 (ISO 8601 フォーマット)。
links: API または Bitbucket でのコミットおよびコミットステータスの表現へのリンク。

repo:commit_status_created ペイロード

{
  "actor": Account,
  "repository": Repository,
  "commit_status": {
    "name": "Unit Tests (Python)",
    "description": "Build started",
    "state": "INPROGRESS",
    "key": "mybuildtool",
    "url": "https://my-build-tool.com/builds/MY-PROJECT/BUILD-777",
    "type": "build",
    "created_on": "2015-11-19T20:37:35.547563+00:00",
    "updated_on": "2015-11-19T20:37:35.547563+00:00",

    "links": {
      "commit": {
        "href": "http://api.bitbucket.org/2.0/repositories/tk/test/commit/9fec847784abb10b2fa567ee63b85bd238955d0e"
      },
      "self": {
        "href": "http://api.bitbucket.org/2.0/repositories/tk/test/commit/9fec847784abb10b2fa567ee63b85bd238955d0e/statuses/build/mybuildtool"
      }
    }
  }
}

ビルドステータスの更新

ビルドシステム、CI ツール、または別のベンダーでは、コミットの新しいステータスを認識し、コミットをそのステータスで更新します。このペイロードには repo:commit_status_updated のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	コミットステータスを更新したユーザー。Bitbucket Connect アプリの場合は、アプリが代理として機能するワークスペースユーザーです。 `User` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	コミットがあるリポジトリ。`Repository` エンティティの例を参照してください。
`commit_status`	コミットステータスの詳細。次のプロパティが含まれています。 `name`: コミットステータスの名前。 `description`: コミットステータスの説明。 `state`: コミットステータス。`INPROGRESS`、`SUCCESSFUL`、または `FAILED` のいずれかです。 `key`: ステータスを同じコミットに関連付けられた他のステータスと識別するためにシステムまたはベンダーが提供するキー。 `url`: ステータスを生成するベンダーまたはシステムへの URL。 `type`: コミットステータスのタイプ。現時点では、Bitbucket はコミットステータスをビルドと関連付けることのみ可能です。したがって、サポートされているタイプは `build` のみです。 `created_on`: コミットステータスが作成された日時 (ISO 8601 フォーマット)。 `updated_on`: コミットステータスが最後に更新された日時 (ISO 8601 フォーマット)。 `links`: API または Bitbucket でのコミットおよびコミットステータスの表現へのリンク。

パラメーター

説明

actor

コミットステータスを更新したユーザー。Bitbucket Connect アプリの場合は、アプリが代理として機能するワークスペースユーザーです。

User エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

repository

コミットがあるリポジトリ。Repository エンティティの例を参照してください。

commit_status

コミットステータスの詳細。次のプロパティが含まれています。

name: コミットステータスの名前。
description: コミットステータスの説明。
state: コミットステータス。INPROGRESS、SUCCESSFUL、または FAILED のいずれかです。
key: ステータスを同じコミットに関連付けられた他のステータスと識別するためにシステムまたはベンダーが提供するキー。
url: ステータスを生成するベンダーまたはシステムへの URL。
type: コミットステータスのタイプ。現時点では、Bitbucket はコミットステータスをビルドと関連付けることのみ可能です。したがって、サポートされているタイプは build のみです。
created_on: コミットステータスが作成された日時 (ISO 8601 フォーマット)。
updated_on: コミットステータスが最後に更新された日時 (ISO 8601 フォーマット)。
links: API または Bitbucket でのコミットおよびコミットステータスの表現へのリンク。

repo:commit_status_updated ペイロード

{
  "actor": Account,
  "repository": Repository,
  "commit_status": {
    "name": "Unit Tests (Python)",
    "description": "All tests passed",
    "state": "SUCCESSFUL",
    "key": "mybuildtool",
    "url": "https://my-build-tool.com/builds/MY-PROJECT/BUILD-792",
    "type": "build",
    "created_on": "2015-11-19T20:37:35.547563+00:00",
    "updated_on": "2015-11-20T08:01:16.433108+00:00",

    "links": {
      "commit": {
        "href": "http://api.bitbucket.org/2.0/repositories/tk/test/commit/9fec847784abb10b2fa567ee63b85bd238955d0e"
      },
      "self": {
        "href": "http://api.bitbucket.org/2.0/repositories/tk/test/commit/9fec847784abb10b2fa567ee63b85bd238955d0e/statuses/build/mybuildtool"
      }
    }
  }
}

課題のイベント

課題で発生する次のイベントのために webhook を作成できます。

created

ユーザーによるリポジトリでの課題の作成です。このペイロードには issue:created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター

説明

actor

課題を作成したユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

issue

ユーザーが作成した課題。Issue エンティティの例を参照してください。

repository

課題があるリポジトリ。Repository エンティティの例を参照してください。

issue:created ペイロード

{
  "actor": Account,
  "issue": Issue,
  "repository": Repository
}

更新日

ユーザーによるリポジトリの課題の更新です。このペイロードには issue:updated のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	課題を作成したユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`issue`	ユーザーが作成した課題。`Issue` エンティティの例を参照してください。
`repository`	課題があるリポジトリ。`Repository` エンティティの例を参照してください。
`comment`	課題への更新について追加されたコメント。`Comment` エンティティの例を参照してください。
`changes`	課題に対する変更の詳細。次のプロパティが含まれています。 `old`: 課題フィールドの前の値。 `new`: 課題フィールドの新しい値。

issue:updated ペイロード

{
  "actor": Account,
  "issue": Issue,
  "repository": Repository,

  "comment": Comment,

  "changes": {

    "status": {

      "old": "open",

      "new": "on hold"

    }

  }

}

コメントの作成

ユーザーによる、リポジトリに関連付けられている課題へのコメントの追加です。このペイロードには issue:comment_created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	課題にコメントを追加するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	課題があるリポジトリ。`Repository` エンティティの例を参照してください。
`issue`	作成された課題。`Issue` エンティティの例を参照してください。
`comment`	作成されたコメント。`Comment` エンティティの例を参照してください。

issue:comment_created ペイロード

{

  "actor": Account,
  "repository": Repository,
  "issue": Issue,
  "comment": Comment
}

プルリクエストイベント

プルリクエストで発生する次のイベントのために webhook を作成できます。

created

ユーザーによるリポジトリでのプルリクエストの作成です。このペイロードには pullrequest:created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストを作成するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	新しいプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	課題を含むリポジトリの表現。`Repository` エンティティの例を参照してください。

パラメーター

説明

actor

プルリクエストを作成するユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

pullrequest

新しいプルリクエスト。Pull Request エンティティの例を参照してください。

repository

課題を含むリポジトリの表現。Repository エンティティの例を参照してください。

pullrequest:created ペイロード

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository
}

更新日

ユーザによるリポジトリでのプルリクエストの更新です。このペイロードには pullrequest:updated のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストを更新するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	更新されたプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。

パラメーター

説明

actor

プルリクエストを更新するユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

pullrequest

更新されたプルリクエスト。Pull Request エンティティの例を参照してください。

repository

プルリクエストが所属するリポジトリ。Repository エンティティの例を参照してください。

pullrequest:updated ペイロード

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository
}

作成された変更リクエスト

ユーザーはリポジトリへのプルリクエストの変更をリクエストしています。このペイロードには pullrequest:changes_request_created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストへの変更をリクエストしているユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	作成済みの変更リクエストがあるプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`changes_request`	以下のプロパティを含む変更リクエストの詳細: `date`: 変更リクエストが作成された日。 `user`: 変更リクエストを作成したユーザー。

pullrequest:changes_request_created payload

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository,
  "changes_request": {
    "date": "2015-04-06T16:34:59.195330+00:00",
    "user": User
  }
}

削除された変更リクエスト

ユーザーはリポジトリへのプルリクエストから変更リクエストを削除しています。このペイロードには pullrequest:changes_request_removed のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	リクエストした変更を削除しているユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	削除された変更リクエストがあるプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリの表現。`Repository` エンティティの例を参照してください。
`changes_request`	以下のプロパティを含む変更リクエストの詳細: `date`: 変更リクエストが削除された日。 `user`: 変更リクエストを削除したユーザー。

pullrequest:changes_request_removed payload

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository,
  "changes_request": {
    "date": "2015-04-06T16:34:59.195330+00:00",
    "user": User
  }
}

承認

ユーザーによるリポジトリでのプルリクエストの承認です。このペイロードには pullrequest:approved のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストを承認するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	承認されたプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`approval`	承認の詳細。次のプロパティが含まれています。 `date`: 承認の作成日。 `user`: 承認を作成したユーザー。

pullrequest:approved ペイロード

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository,
  "approval": {
    "date": "2015-04-06T16:34:59.195330+00:00",
    "user": User
  }
}

承認の取り消し

ユーザーによるリポジトリでのプルリクエストからの承認の削除です。このペイロードには pullrequest:unapproved のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	承認を削除するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	削除された承認のプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリの表現。`Repository` エンティティの例を参照してください。
`approval`	承認の詳細。次のプロパティが含まれています。 `date`: 承認の作成日。 `user`: 承認を作成したユーザー。

pullrequest:unapproved ペイロード

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository,
  "approval": {
    "date": "2015-04-06T16:34:59.195330+00:00",
    "user": User
  }
}

マージ

ユーザーによるリポジトリでのプルリクエストのマージです。このペイロードには pullrequest:fulfilled のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストをマージするユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	マージされたプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。

パラメーター

説明

actor

プルリクエストをマージするユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

pullrequest

マージされたプルリクエスト。Pull Request エンティティの例を参照してください。

repository

プルリクエストが所属するリポジトリ。Repository エンティティの例を参照してください。

pullrequest:fulfilled ペイロード

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository

}

却下

ユーザーによるリポジトリでのプルリクエストの却下です。このペイロードには pullrequest:rejected のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストを却下したユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`pullrequest`	却下されたプルリクエスト。`Pull Request` エンティティの例を参照してください。
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。

パラメーター

説明

actor

プルリクエストを却下したユーザー。Account エンティティの例を参照してください。

Note: An Account type can be one of three subtypes - User, Team or AppUser.

pullrequest

却下されたプルリクエスト。Pull Request エンティティの例を参照してください。

repository

プルリクエストが所属するリポジトリ。Repository エンティティの例を参照してください。

pullrequest:rejected ペイロード

{
  "actor": Account,
  "pullrequest": PullRequest,
  "repository": Repository

}

コメントの作成

ユーザーによるプルリクエストへのコメント追加です。このペイロードには pullrequest:comment_created のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストにコメントするユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`pull request`	コメントを持つプルリクエスト。`Pull Request` エンティティの例を参照してください。
`comment`	作成されたコメント。`Comment` エンティティの例を参照してください。

pullrequest:comment_created ペイロード

{

  "actor": Account,
  "repository": Repository,
  "pullrequest": PullRequest,
  "comment": Comment
}

コメントの更新

ユーザーによるプルリクエストのコメントの更新です。ユーザーが同じ再びすぐにコメントを更新する場合、Bitbucket は初回のコメント更新時にのみイベントリクエストを送信します。ユーザーが時間を空けてから再度コメントを更新する場合、Bitbucket は 2 回目にイベントリクエストを送信します。

このペイロードには pullrequest:comment_updated のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストのコメントを更新するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`pull request`	コメントを持つプルリクエスト。`Pull Request` エンティティの例を参照してください。
`comment`	更新されたコメント。`Comment` エンティティの例を参照してください。

pullrequest:comment_updated ペイロード

{

  "actor": Account,
  "repository": Repository,
  "pullrequest": PullRequest,
  "comment": Comment
}

コメントの削除

ユーザーがプルリクエストでコメントを削除します。このペイロードには pullrequest:comment_deleted のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストでコメントを削除するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`pull request`	コメントを持つプルリクエスト。`Pull Request` エンティティの例を参照してください。
`comment`	削除されたコメント。`Comment` エンティティの例を参照してください。

pullrequest:comment_deleted ペイロード

{

  "actor": Account,
  "repository": Repository,
  "pullrequest": PullRequest,
  "comment": Comment
}

コメントの解決

ユーザーがプルリクエストでコメントを解決します。このペイロードには pullrequest:comment_resolved のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストでコメントを削除するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`pull request`	コメントを持つプルリクエスト。`Pull Request` エンティティの例を参照してください。
`comment`	削除されたコメント。`Comment` エンティティの例を参照してください。

pullrequest:comment_resolved ペイロード

{
  "actor": Account,
  "repository": Repository,
  "pullrequest": PullRequest,
  "comment": Comment
}

コメントの再オープン

ユーザーがプルリクエストのコメントを再オープンします。このペイロードには pullrequest:comment_reopened のイベントキーが含まれており、次のフィールドが提供されます。

パラメーター	説明
`actor`	プルリクエストでコメントを削除するユーザー。`Account` エンティティの例を参照してください。 Note: An `Account` type can be one of three subtypes - `User`, `Team` or `AppUser`.
`repository`	プルリクエストが所属するリポジトリ。`Repository` エンティティの例を参照してください。
`pull request`	コメントを持つプルリクエスト。`Pull Request` エンティティの例を参照してください。
`comment`	削除されたコメント。`Comment` エンティティの例を参照してください。

pullrequest:comment_reopened ペイロード

{
  "actor": Account,
  "repository": Repository,
  "pullrequest": PullRequest,
  "comment": Comment
}