{"meta":{"title":"存储库统计信息的 REST API 终结点","intro":"使用 REST API 获取 GitHub 用于可视化不同类型存储库活动的数据。","product":"REST API","breadcrumbs":[{"href":"/zh/rest","title":"REST API"},{"href":"/zh/rest/metrics","title":"指标"},{"href":"/zh/rest/metrics/statistics","title":"统计信息"}],"documentType":"article"},"body":"# 存储库统计信息的 REST API 终结点\n\n使用 REST API 获取 GitHub 用于可视化不同类型存储库活动的数据。\n\n## 关于存储库统计信息\n\n可使用 REST API 获取 GitHub 用于可视化不同类型存储库活动的数据。\n\n### 缓存最佳做法\n\n计算存储库统计信息是一项昂贵的操作，所以我们尽可能返回缓存的数据。 如果你查询存储库的统计信息时数据尚未缓存，你将会收到 `202` 响应；同时触发后台作业以开始编译这些统计信息。 应留出片刻时间让作业完成，然后再次提交请求。 如果作业已完成，该请求将返回 `200` 响应，响应正文中包含统计信息。\n\n仓库统计信息由仓库默认分支的 SHA 缓存；推送到默认分支将重置统计信息缓存。\n\n### 统计排除某些类型的提交\n\nAPI 公开的统计信息与[不同存储库图](/zh/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs)显示的统计信息匹配。\n\n总结：\n\n* 所有统计数据均不包括合并提交。\n* 参与者统计信息还排除空提交。\n\n> \\[!NOTE]\n> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.\n\n## Get the weekly commit activity\n\n```\nGET /repos/{owner}/{repo}/stats/code_frequency\n```\n\nReturns a weekly aggregate of the number of additions and deletions pushed to a repository.\nNote\n\nThis endpoint can only be used for repositories with fewer than 10,000 commits. If the repository contains 10,000 or more commits, a 422 status code will be returned.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - Returns a weekly aggregate of the number of additions and deletions pushed to a repository.\n\n* **202** - Accepted\n\n* **204** - A header with no content is returned.\n\n* **422** - Repository contains more than 10,000 commits\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/stats/code_frequency\n```\n\n**Response schema (Status: 200):**\n\nArray of array\n\n## Get the last year of commit activity\n\n```\nGET /repos/{owner}/{repo}/stats/commit_activity\n```\n\nReturns the last year of commit activity grouped by week. The days array is a group of commits per day, starting on Sunday.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **202** - Accepted\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/stats/commit_activity\n```\n\n**Response schema (Status: 200):**\n\nArray of `Commit Activity`:\n\n* `days`: required, array of integer\n* `total`: required, integer\n* `week`: required, integer\n\n## Get all contributor commit activity\n\n```\nGET /repos/{owner}/{repo}/stats/contributors\n```\n\nReturns the total number of commits authored by the contributor. In addition, the response includes a Weekly Hash (weeks array) with the following information:\n\nw - Start of the week, given as a Unix timestamp.\na - Number of additions\nd - Number of deletions\nc - Number of commits\n\nNote\n\nThis endpoint will return 0 values for all addition and deletion counts in repositories with 10,000 or more commits.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **202** - Accepted\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/stats/contributors\n```\n\n**Response schema (Status: 200):**\n\nArray of `Contributor Activity`:\n\n* `author`: required, any of:\n  * **null**\n  * **Simple User**\n    * `name`: string or null\n    * `email`: string or null\n    * `login`: required, string\n    * `id`: required, integer, format: int64\n    * `node_id`: required, string\n    * `avatar_url`: required, string, format: uri\n    * `gravatar_id`: required, string or null\n    * `url`: required, string, format: uri\n    * `html_url`: required, string, format: uri\n    * `followers_url`: required, string, format: uri\n    * `following_url`: required, string\n    * `gists_url`: required, string\n    * `starred_url`: required, string\n    * `subscriptions_url`: required, string, format: uri\n    * `organizations_url`: required, string, format: uri\n    * `repos_url`: required, string, format: uri\n    * `events_url`: required, string\n    * `received_events_url`: required, string, format: uri\n    * `type`: required, string\n    * `site_admin`: required, boolean\n    * `starred_at`: string\n    * `user_view_type`: string\n* `total`: required, integer\n* `weeks`: required, array of objects:\n  * `w`: integer\n  * `a`: integer\n  * `d`: integer\n  * `c`: integer\n\n## Get the weekly commit count\n\n```\nGET /repos/{owner}/{repo}/stats/participation\n```\n\nReturns the total commit counts for the owner and total commit counts in all. all is everyone combined, including the owner in the last 52 weeks. If you'd like to get the commit counts for non-owners, you can subtract owner from all.\nThe array order is oldest week (index 0) to most recent week.\nThe most recent week is seven days ago at UTC midnight to today at UTC midnight.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - The array order is oldest week (index 0) to most recent week.\n\n* **404** - Resource not found\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/stats/participation\n```\n\n**Response schema (Status: 200):**\n\n* `all`: required, array of integer\n* `owner`: required, array of integer\n\n## Get the hourly commit count for each day\n\n```\nGET /repos/{owner}/{repo}/stats/punch_card\n```\n\nEach array contains the day number, hour number, and number of commits:\n\n0-6: Sunday - Saturday\n0-23: Hour of day\nNumber of commits\n\nFor example, \\[2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - For example, \\[2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/stats/punch_card\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Get the weekly commit activity](#get-the-weekly-commit-activity)."}