Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

速率限制

使用速率限制 API,可以检查各种 REST API 的当前速率限制状态。

关于速率限制 API

REST API 概述文档介绍了速率限制规则。 您可以随时使用下面描述的速率限制 API 来检查您当前的速率限制状态。

了解您的速率限制状态

搜索 API 具有自定义速率限制,与管理 REST API 其余部分的速率限制不同。 GraphQL API 也有自定义速率限制,它与 REST API 中的速率限制不同且计算方式也不同。

出于这些原因,速率限制 API 响应对速率限制进行分类。 在 resources 下,你将看到四个对象:

  • core 对象提供 REST API 中所有非搜索相关资源的速率限制状态。

  • search 对象提供搜索 API 的速率限制状态。

  • graphql 对象提供 GraphQL API 的速率限制状态。

  • integration_manifest 对象提供 GitHub 应用部件清单代码转换终结点的速率限制状态。

有关速率限制响应中的标头和值的详细信息,请参阅“REST API 中的资源”。

Get rate limit status for the authenticated user

Note: Accessing this endpoint does not count against your REST API rate limit.

Note: The rate object is deprecated. If you're writing new API client code or updating existing code, you should use the core object instead of the rate object. The core object contains the same information that is present in the rate object.

HTTP 响应状态代码

状态代码说明
200

OK

304

Not modified

404

Resource not found

代码示例

get/rate_limit
curl \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ http(s)://HOSTNAME/api/v3/rate_limit

Response

Status: 200
{ "resources": { "core": { "limit": 5000, "remaining": 4999, "reset": 1372700873, "used": 1 }, "search": { "limit": 30, "remaining": 18, "reset": 1372697452, "used": 12 }, "graphql": { "limit": 5000, "remaining": 4993, "reset": 1372700389, "used": 7 }, "integration_manifest": { "limit": 5000, "remaining": 4999, "reset": 1551806725, "used": 1 }, "code_scanning_upload": { "limit": 500, "remaining": 499, "reset": 1551806725, "used": 1 } }, "rate": { "limit": 5000, "remaining": 4999, "reset": 1372700873, "used": 1 } }