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 是 hello-world 个人帐户拥有的 octocat 存储库的名称。
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"

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

CommitCommentEvent

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

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

用于 CommitCommentEvent 的事件对象 payload

密钥	类型	说明
comment	object

          [提交注释](/rest/commits#get-a-commit-comment)资源。

创建事件

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

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

CreateEvent 的事件 payload 对象

数据reusables.webhooks.create_properties %}

DeleteEvent

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

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

DeleteEvent 的事件 payload 对象

密钥	类型	说明
ref	string

          [
          `git ref`
          ](/rest/git#get-a-reference)资源分支。

ref_type|string | 在存储库中删除的 Git 引用对象的类型。 可以为 branch 或 tag。 | | pusher_type|string | 可以是 user 或部署密钥。

ForkEvent

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

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

ForkEvent 的事件 payload 对象

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

GollumEvent

数据可复用.webhooks.gollum_short_desc %}

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

GollumEvent 的事件 payload 对象

数据reusables.webhooks.gollum_properties %}

IssueCommentEvent

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

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

IssueCommentEvent 的事件 payload 对象

密钥	类型	说明
action	string	在评论上执行的操作。 可以为 created。
issue

          |
          `object` | 注释所属的[议题](/rest/issues)。

          `comment`
          |
          `object` | [注释](/rest/issues#comments)本身。

IssuesEvent

数据reusables.webhooks.issues_short_desc %}

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

IssuesEvent 的事件 payload 对象

数据reusables.webhooks.issue_event_api_properties %}数据reusables.webhooks.issue_properties %}

MemberEvent

数据reusables.webhooks.member_short_desc %}

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

MemberEvent 的 Event payload 对象

数据reusables.webhooks.member_event_api_properties %}数据reusables.webhooks.member_properties %}

PublicEvent

当私有仓库公开时。

PublicEvent 的 payload 事件对象

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

PullRequestEvent

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

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

PullRequestEvent 的 payload 事件对象

数据reusables.webhooks.pull_request_event_api_properties %}数据reusables.webhooks.pull_request_properties %}

PullRequestReviewEvent

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

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

PullRequestReviewEvent 事件对象 payload

数据reusables.webhooks.pull_request_review_properties %}

PullRequestReviewCommentEvent

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

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

PullRequestReviewCommentEvent 的 payload 事件对象

密钥	类型	说明
action	string	在评论上执行的操作。 可以为 created。
pull_request

          |
          `object` | 注释所属于的[拉取请求](/rest/pulls)。

          `comment`
          |
          `object` | [注释](/rest/pulls#comments)本身。

PushEvent

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

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

PushEvent 的 payload 事件对象

Key	类型	Description
repository_id	integer	发生推送的存储库的唯一标识符。
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

数据reusables.webhooks.release_short_desc %}

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

用于 ReleaseEvent 的 payload 事件对象

密钥	类型	说明
action	string	执行的操作内容. 可以为 published。
release

          |
          `object` | [release](/rest/releases/releases#get-a-release) 对象。

WatchEvent

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

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

WatchEvent 的事件 payload 对象

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