CNB 文档

简体中文

English

简体中文

English

外观

仓库动态

2019 字约 7 分钟

概述

仓库动态会记录 CNB 上触发的不同类型的仓库事件。每个动态事件返回包含通用属性, 和其动态类型决定的 payload 对象。

仓库动态按照小时为最小分片单位记录 CNB 所有仓库的操作动态, 目前记录的动态类型有:

  • CreateEvent
  • DeleteEvent
  • ForkEvent
  • IssueCommentEvent
  • IssueEvent
  • MemberEvent
  • PublicEvent
  • PullRequestEvent
  • PullRequestReviewEvent
  • PullRequestReviewCommentEvent
  • PushEvent
  • ReleaseEvent
  • WatchEvent

API 接口

获取仓库指定时间内的动态

  • 接口地址: /events/{repo_path}/-/{date}
  • 接口方法: "GET"
  • 输入参数:
    • repo_path: 仓库的完整路径, eg: /cnb/test
    • date: 时间区间, 格式为 yy-mm-dd-h, eg: 2025-09-11-7, 表示2025年9月11日7:00:00～7:59:59时间区间
  • 返回:
    仓库动态列表, 仓库动态因为事件类型的不同结构会有差别, 但都有通用的结构属性。
    • eventObject: 动态事件结构, 由动态通用属性 + payload 组成。

动态通用属性

  • id: int, 动态 id, 唯一值。
  • type: string, 动态类型, 详情见‘概述’。
  • actor: object, 动态触发人。
    • id: int, 用户 id。
    • username: string, 用户名。
    • nickname: string, 用户昵称。
    • url: string, 查询用户的 OPENAPI 地址, 其中包括额外的用户详情。
    • avatar_url: string, 用户头像地址。
  • repo: object, 动态所属仓库详情。
    • id: int, 仓库 id。
    • path: string, 仓库全路径。
    • url: string, 查询仓库的 OPENAPI 地址。
  • created_at: string, 动态触发时间, 格式为ISO 8601格式。

Payload

CreateEvent

记录仓库, 分支, 标签的创建动态。

  • ref: string, git ref 资源, 当 ref_type 为 repository 时, ref 为空字符串。
  • ref_type: string, git ref 对象类型, 包含 branch, tag, repository。
  • master_branch: string, 仓库主干分支。
  • description: string, 仓库描述。
  • pusher_type: string, 推送者类型, 定值 "user"。
DeleteEvent

记录分支, 标签的删除动态。

  • ref: string, git ref 资源。
  • ref_type: string, git ref 对象类型, 包含 branch, tag。
ForkEvent

记录仓库 fork 动态。

  • forkee: repo object, fork 的仓库资源。
    • id: int, 仓库 id。
    • name: string, 仓库名。
    • full_name: string, 仓库全路径。
    • owner: user object, 仓库创建用户详情。
      • id: int, 创建者 id。
      • username: string, 用户名。
      • url: string, 查询用户的 OPENAPI 地址, 其中包括额外的用户详情。
      • avatar_url: string, 用户头像地址。
      • html_url: string, 用户主页地址。
      • followers_url: string, 用户粉丝列表地址。
      • following_url: string, 用户关注列表地址。
      • starred_url: string, 用户关注列表地址。
      • organizations_url: string, 用户组织列表地址。
      • repos_url: string, 用户仓库列表地址。
      • type: string, 用户类型, 包含 "wechat_user" - 微信用户, "robot_user" - 机器人。
    • private: bool, 是否为私有仓库。
    • html_url: string, 仓库 CNB 地址。
    • description: string, 仓库简介。
    • fork: bool, 是否为 fork 创建。
    • url: string, 仓库详情查询 OPENAPI 地址。
    • branches_url: string, OPENAPI 地址, 仓库分支列表查询。
    • collaborators_url: string, OPENAPI 地址, 仓库成员列表查询。
    • compare_url: string, OPENAPI 地址, 分支差异比较。
    • contents_url: string, OPENAPI 地址, 仓库文件查询。
    • contributors_url: string, OPENAPI 地址, 仓库成员列表查询。
    • forks_url: string, OPENAPI 地址, 仓库 fork 列表查询。
    • git_commits_url: string, OPENAPI 地址, 查询指定提交详情。
    • git_tags_url: string, OPENAPI 地址, 查询指定标签详情。
    • issue_comment_url: string, OPENAPI 地址, 查询 issue 评论列表。
    • issues_url: string, OPENAPI 地址, 查询 issue 列表。
    • labels_url: string, OPENAPI 地址, 查询 issue 标签列表。
    • pulls_url: string, OPENAPI 地址, 查询 pr 列表。
    • releases_url: string, OPENAPI 地址, 查询 release 列表。
    • stargazers_url: string, OPENAPI 地址, 查询 star 仓库的用户列表。
    • tags_url: string, OPENAPI 地址, 查询标签列表。
    • clone_url: string, 仓库 clone 地址。
    • homepage: string, 仓库主页。
    • language: string, 仓库主语言。
    • forks_count: int, 仓库被 fork 的次数。
    • stargazers_count: int, 仓库被 star 的次数。
    • size: int, 仓库存储大小。
    • default_branch: string, 仓库默认分支。
    • open_issues_count: int, 仓库开启状态的 issue 数。
    • topics: string list, 仓库标签列表。
    • has_issues: bool, 仓库是否有 issue。
    • archived: bool, 仓库是否归档。
    • disabled: bool, 仓库是否不可用。
    • visibility: string, 仓库可见性。
    • pushed_at: string, 仓库最近一次 push 的时间。
    • created_at: string, 仓库创建时间。
    • updated_at: string, 仓库更新时间。
    • license: string, 仓库许可证。
IssueCommentEvent

记录 issue 评论动态。

  • action: string, 评论操作, 包括 created, edited, deleted。
  • issue: issue object, 评论所属 issue 详情。
    • id: int, issue id。
    • url: string, OPENAPI 地址, 查询指定 issue 详情。
    • repository_url: string, OPENAPI 地址, 查询 issue 所在仓库详情。
    • labels_url: string, OPENAPI 地址, 查询 issue 的标签列表。
    • comments_url: string, OPENAPI 地址, 查询 issue 的评论。
    • html_url: string, issue 的 CNB 地址。
    • number: int, issue 的仓库序列号。
    • state: string, issue 状态。
    • title: string, issue 标题。
    • labels: label object list, issue 标签列表。
      • name: string, 标签名。
      • description: string, 标签简介。
      • color: string, 标签颜色。
    • assignees: user object list, issue 处理人, 对象结构同 ForkEvent user object。
    • comments: int, issue 评论数。
    • closed_at: string, issue 关闭时间。
    • created_at: string, issue 创建时间。
    • updated_at: string, issue 更新时间。
  • comment: comment object, 评论详情。
    • id: int, 评论 id
    • url: string, OPENAPI 地址, 查询评论详情。
    • html_url: string, 评论 CNB 地址。
    • body: string, 评论内容。
    • user: user object, 评论人, 对象结构同 ForkEvent user object。
    • created_at: string, 评论创建时间。
    • updated_at: string, 评论更新时间。
    • issue_url: string, OPENAPI 地址, 查询评论所在 issue 详情。
IssueEvent

记录 issue 动态。

  • action: string, issue 操作, 包括 opened, edited, closed, reopened, assigned, unassigned, labeled, unlabeled。
  • issue: issue object, issue 详情, 对象结构同 IssueCommentEvent issue object。
  • assignees: user object, 处理人, 对象结构同 ForkEvent user object。
  • labels: label object, issue 标签, 对象结构同 IssueCommentEvent label object。
MemberEvent

记录添加仓库成员动态。

  • action: string, 成员操作, 包括 added。
  • member: user object, 新增成员, 对象结构同 ForkEvent user object。
PublicEvent

记录私有仓库转变为公仓的动态。

PullRequestEvent

记录 pr 动态。

  • action: string, pr 操作, 包括 opened, closed, reopened, edited。
  • number: int, pr 的仓库序列号。
  • pull_request: pull_request object, pr 详情。
    • id: int, pr id。
    • url: string, OPENAPI 地址, 查询 pr 详情。
    • html_url: string, pr CNB 地址。
    • diff_url: string, pr diff CNB 地址。
    • commits_url: string, pr CNB 提交详情地址。
    • number: int, pr 仓库序列号。
    • state: string, pr 状态。
    • title: string, pr 标题。
    • user: user object, pr 创建人, 对象结构同 ForkEvent user object。
    • body: string, pr 详情。
    • labels: label object list, pr 标签列表, 对象结构同 IssueCommentEvent label object。
    • created_at: string, pr 创建时间。
    • updated_at: string, pr 更新时间。
    • closed_at: string, pr 关闭时间。
    • merged_at: string, pr merge 时间。
    • assignees: user object list, 处理人列表, 对象结构同 ForkEvent user object。
    • requested_reviewers: user object list, 评审人列表, 对象结构同 ForkEvent user object。
    • head: branch object, 源分支。
      • ref: string, 分支名。
      • repo: repo object, 分支所属仓库, 对象结构同 ForkEvent repo object。
    • base: branch object, 目标分支, 结构同上。
    • mergeable_state: string, pr 的合并状态。
    • comments: int, pr 的评论数。
PullRequestReviewEvent

记录 pr 的评审动态。

  • action: string, pr 评审操作, 包括 created。
  • pull_request: pull_request object, pr 详情, 对象结构同 PullRequestEvent pull_request object。
PullRequestReviewCommentEvent

记录 pr 的评审评论。

  • action: string, pr 评审操作, 包括 opened, edited, deleted。
  • pull_request: pull_request object, pr 详情, 对象结构同 PullRequestEvent pull_request object。
  • comment: comment object, 评论详情, 对象结构同 IssueCommentEvent comment object。
PushEvent

记录仓库 push 动态。

  • push_id: string, 推送 id。
  • distinct_size: int, 提交去重后的推送大小。
  • ref: string, 推送 ref 名。
  • head: string, 推送后最近一次提交 sha。
  • before: string, 推送前最近一次提交 sha。
  • commits: commit object list, 提交详情列表。
    • sha: string, 提交 sha。
    • message: string, 提交信息。
    • url: string, OPENAPI 地址, 查询指定提交详情。
    • author: author object, 提交人。
      • name: string, 提交人名称。
      • email: string, 提交人邮箱。
    • distinct: bool, 是否为新提交。
ReleaseEvent

记录仓库 release 动态。

  • action: string, release 操作, 包括 published, edited, deleted。
  • release: release object, release 详情。
    • id: int, release id。
    • url: string, OPENAPI 地址, 查询指定 release 详情。
    • html_url: string, release CNB 地址。
    • assets_url: string, OPENAPI 地址, 查询 release 附件。
    • tag_name: string, 标签名。
    • target_commitish: string, release 截止提交 sha。
    • name: string, release 名。
    • body: string, release 详情。
    • draft: bool, 是否为草稿。
    • prerelease: bool, 是否为最新的 release。
    • created_at: string, release 创建时间。
    • published_at: string, release 发布时间。
    • author: user object, 创建人, 对象结构同 ForkEvent user object。
    • assets: release_asset object list, release 附件。
      • id: int, 附件 id。
      • name: string, 附件名。
      • url: string, OPENAPI 地址, 查询指定附件详情。
      • label: string, 附件标签。
      • state: string, 附件状态。
      • content_type: string, 附件文本类型。
      • size: int, 附件大小。
      • digest: string, 附件摘要哈希值。
      • download_count: int, 附件下载次数。
      • created_at: string, 附件创建时间。
      • updated_at: string, 附件更新时间。
WatchEvent

记录仓库 star 动态。

  • action: string, star 操作, 包含 started。

© 2025 cnb.cool