Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.


使用 REST API 检查当前速率限制状态。


你可以在任何时候检查当前的速率限制状态。 有关速率限制规则的详细信息,请参阅“REST API 中的资源”。

用于搜索项的 REST API 具有自定义速率限制,与控制其他 REST API 终结点的速率限制不同。 有关详细信息,请参阅“搜索”。 GraphQL API 也有自定义速率限制,它与 REST API 中的速率限制不同且计算方式也不同。 有关详细信息,请参阅“资源限制”。 出于这些原因,API 响应会对速率限制进行分类。 在 resources 下,你将看到与不同类别相关的对象:

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

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

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

  • integration_manifest 对象提供 POST /app-manifests/{code}/conversions 操作的速率限制状态。 有关详细信息,请参阅“通过清单创建 GitHub 应用”。

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

Get rate limit status for the authenticated user

Works with GitHub Apps

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 response status codes

Status code说明



Not modified


Resource not found

Code samples

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


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 } }