GitHub 事件类型

事件 API 可以返回 GitHub 上的活动触发的不同类型事件。每个事件响应都包含共享属性，但具有由其事件类型确定的唯一 payload 对象。事件对象公共属性描述所有事件共享的属性，而每个事件类型描述特定事件唯一的 payload 属性。

事件对象公共属性

从事件 API 端点返回的事件对象具有相同的结构。

事件 API 属性名称	类型	说明
`id`	`integer`	事件的唯一标识符。
`type`	`string`	事件的类型。事件使用 PascalCase 作为名称。
`actor`	`object`	触发事件的用户。
`actor.id`	`integer`	执行者的唯一标识符。
`actor.login`	`string`	执行者的用户名。
`actor.display_login`	`string`	用户名的特定显示格式。
`actor.gravatar_id`	`string`	执行者的 Gravatar 个人资料的唯一标识符。
`actor.url`	`string`	用于检索用户对象的 REST API URL，其中包括更多用户信息。
`actor.avatar_url`	`string`	执行者个人资料图像的 URL。
`repo`	`object`	发生事件的仓库对象。
`repo.id`	`integer`	仓库的唯一标识符。
`repo.name`	`string`	仓库名称，包括所有者和仓库的名称。例如，`octocat/hello-world` 是 `octocat` 个人帐户拥有的 `hello-world` 存储库的名称。
`repo.url`	`string`	用于检索仓库对象的 REST API URL，其中包括更多仓库信息。
`payload`	`object`	事件有效负载对象对于事件类型是唯一的。有关事件 API `payload` 对象，请参阅下面的事件类型。
`public`	`boolean`	事件是否对所有用户可见。
`created_at`	`string`	触发事件的日期和时间。它根据 ISO 8601 设置格式。
`org`	`object`	由行动者选择的组织来执行触发事件的操作。该属性仅在适用时才会显示在事件对象中。
`org.id`	`integer`	组织的唯一标识符。
`org.login`	`string`	组织名称。
`org.gravatar_id`	`string`	组织的 Gravatar 配置文件的唯一标识符。
`org.url`	`string`	用于检索组织对象的 REST API URL，其中包括更多组织信息。
`org.avatar_url`	`string`	组织的配置文件图像的 URL。

WatchEvent 事件对象示例

此示例显示了使用事件 API 时 WatchEvent 响应的格式。

HTTP/2 200
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"

[
  {
    "type": "WatchEvent",
    "public": false,
    "payload": {
    },
    "repo": {
      "id": 3,
      "name": "octocat/Hello-World",
      "url": "https://api.github.com/repos/octocat/Hello-World"
    },
    "actor": {
      "id": 1,
      "login": "octocat",
      "gravatar_id": "",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "url": "https://api.github.com/users/octocat"
    },
    "org": {
      "id": 1,
      "login": "github",
      "gravatar_id": "",
      "url": "https://api.github.com/orgs/github",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif"
    },
    "created_at": "2011-09-06T17:26:27Z",
    "id": "12345"
  }
]

CommitCommentEvent

提交评论已创建。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“适用于提交注释的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

CommitCommentEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	已执行的操作。可以为 `created`。
`comment`	`object`	提交注释资源。

CreateEvent

Git 分支或标签已创建。有关详细信息，请参阅“Git 数据库的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

CreateEvent 的事件 `payload` 对象

密钥	类型	描述
`ref`	`string`	`git ref` 资源，或者 `null`（如果 `ref_type` 是 `repository`）。
`ref_type`	`string`	在仓库中创建的 Git ref 对象的类型。可以为 `branch`、`tag` 或 `repository`。
`master_branch`	`string`	存储库默认分支的名称（通常为 `main`）。
`description`	`string`	仓库的当前描述。
`pusher_type`	`string`	可以是 `user` 或部署密钥。

DeleteEvent

Git 分支或标签已删除。有关详细信息，请参阅“Git 数据库的 REST API 终结点”REST API。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

DeleteEvent 的事件 `payload` 对象

密钥	类型	说明
`ref`	`string`	`git ref` 资源。
`ref_type`	`string`	在存储库中删除的 Git 引用对象的类型。可以为 `branch` 或 `tag`。

ForkEvent

用户复刻仓库。有关详细信息，请参阅“存储库的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

ForkEvent 的事件 `payload` 对象

密钥	类型	说明
`forkee`	`object`	创建的 `repository` 资源。

GollumEvent

创建或更新 wiki 页面。有关详细信息，请参阅“关于 wikis”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

GollumEvent 的事件 `payload` 对象

密钥	类型	说明
`pages`	`array`	已更新的页面。
`pages[][page_name]`	`string`	页的名称。
`pages[][title]`	`string`	- 当前页标题。
`pages[][action]`	`string`	- 在该页上执行的操作。可以是 `created` 或 `edited`。
`pages[][sha]`	`string`	页面的最新提交 SHA。
`pages[][html_url]`	`string`	指向 HTML wiki 页面。

IssueCommentEvent

与议题或拉取请求评论相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“适用于问题的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

IssueCommentEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	在评论上执行的操作。可以是 `created`、`edited` 或 `deleted` 之一。
`changes`	`object`	对注释的更改（如果操作为 `edited`）。
`changes[body][from]`	`string`	正文的先前版本（如果操作为 `edited`）。
`issue`	`object`	注释所属的议题。
`comment`	`object`	注释本身。

IssuesEvent

与议题相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“适用于问题的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

IssuesEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 可以是 `opened`、`edited`、`closed`、`reopened`、`assigned`、`unassigned`、`labeled` 或 `unlabeled` 之一。
`issue`	`object`	问题本身。
`changes`	`object`	对问题的更改（如果操作为 `edited`）。
`changes[title][from]`	`string`	先前版本的标题（如果操作为 `edited`）。
`changes[body][from]`	`string`	先前版本的正文（如果操作为 `edited`）。
`assignee`	`object`	已分配或未分配问题的可选用户。
`label`	`object`	从问题中添加或删除的可选标签。

MemberEvent

与仓库协作者相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“协作者的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

MemberEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 可以是 `added` 以指示用户接受了加入存储库的邀请。
`member`	`object`	已添加的用户。
`changes`	`object`	如果操作是 `edited`，则是对参与者权限的更改。
`changes[old_permission][from]`	`string`	如果操作是 `edited`，则为协作者以前的权限。

PublicEvent

当私有仓库公开时。毫无疑问：最好的 GitHub Enterprise Server 事件。

PublicEvent 的事件 `payload` 对象

此事件返回一个空 payload 对象。

PullRequestEvent

与拉取请求相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“用于拉取请求的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

PullRequestEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 可以是 `opened`、`edited`、`closed`、`reopened`、`assigned`、`unassigned`、`review_requested`、`review_request_removed`、`labeled`、`unlabeled` 和 `synchronize` 其中之一。
`number`	`integer`	拉取请求号。
`changes`	`object`	对注释的更改（如果操作为 `edited`）。
`changes[title][from]`	`string`	先前版本的标题（如果操作为 `edited`）。
`changes[body][from]`	`string`	先前版本的正文（如果操作为 `edited`）。
`pull_request`	`object`	拉取请求本身。

PullRequestReviewEvent

与拉取请求审查相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“用于拉取请求的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

PullRequestReviewEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 可以为 `created`。
`pull_request`	`object`	与审查相关的拉取请求。
`review`	`object`	受影响的审查。

PullRequestReviewCommentEvent

与拉取请求统一差异中的拉取请求审查评论相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“用于拉取请求的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

PullRequestReviewCommentEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	在评论上执行的操作。可以为 `created`。
`changes`	`object`	对注释的更改（如果操作为 `edited`）。
`changes[body][from]`	`string`	正文的先前版本（如果操作为 `edited`）。
`pull_request`	`object`	注释所属于的拉取请求。
`comment`	`object`	注释本身。

PullRequestReviewThreadEvent

与拉取请求的批注线程相关的活动标记为已解决或未解决。活动类型在有效负载对象的 action 属性中指定。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

PullRequestReviewThreadEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 可以是以下选项之一： `resolved` - 拉取请求上的批注线程被标记为已解决。 `unresolved` - 拉取请求上先前已解决的批注线程标记为未解决。
`pull_request`	`object`	与线程相关的拉取请求。
`thread`	`object`	受影响的线程。

PushEvent

一个或多个提交被推送到仓库分支或标记。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

PushEvent 的事件 `payload` 对象

密钥	类型	说明
`push_id`	`integer`	推送的唯一标识符。
`size`	`integer`	推送中的提交数。
`distinct_size`	`integer`	推送中不同提交的数量。
`ref`	`string`	推送的完整 `git ref`。示例：`refs/heads/main`。
`head`	`string`	推送之后在 `ref` 上最近提交的 SHA。
`before`	`string`	推送之前在 `ref` 上最近提交的 SHA。
`commits`	`array`	描述所推送提交的提交对象数组。（该数组最多包含 20 个提交。如有必要，可使用提交 API 获取更多提交。此限制仅适用于时间表事件，而不适用于 web 挂钩递送。）
`commits[][sha]`	`string`	提交的 SHA。
`commits[][message]`	`string`	提交消息。
`commits[][author]`	`object`	提交的 Git 作者。
`commits[][author][name]`	`string`	Git 作者的名称。
`commits[][author][email]`	`string`	Git 作者的电子邮件地址。
`commits[][url]`	`url`	指向提交 API 资源的 URL。
`commits[][distinct]`	`boolean`	此提交是否与之前推送的任何提交不同。

ReleaseEvent

与发行版相关的活动。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“发布和发布资产的 REST API 终结点”REST API。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

ReleaseEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 可以为 `published`。
`changes[body][from]`	`string`	如果操作是 `edited`，则为先前版本的正文。
`changes[name][from]`	`string`	如果操作是 `edited`，则为先前版本的名称。
`release`	`object`	release 对象。

WatchEvent

当有人标星仓库时。活动类型在有效负载对象的 action 属性中指定。有关详细信息，请参阅“活动的 REST API 终结点”。

事件对象包含所有事件的通用属性。每个事件对象都包含 payload 属性，并且值对于每个事件类型而言都是唯一的。此事件的 payload 对象描述如下。

WatchEvent 的事件 `payload` 对象

密钥	类型	说明
`action`	`string`	执行的操作内容. 目前只能是 `started`。

本文内容