# REST-API-Endpunkte für die Ratenbegrenzung

Verwende die REST-API, um den aktuellen Status der Quotengrenze zu überprüfen.

## Informationen zu Quotengrenzen

Du kannst deinen aktuellen Status der Quotengrenze jederzeit überprüfen. Weitere Informationen zu Ratenbegrenzungsregeln findest du unter [Ratenbegrenzungen für die REST-API](/de/enterprise-server@3.19/rest/overview/rate-limits-for-the-rest-api).

Die REST-API für die Suche nach Elementen verfügt über eine benutzerdefinierte Quotengrenze, die von der Quotengrenze für die anderen REST-API-Endpunkte getrennt ist. Weitere Informationen finden Sie unter [REST-API-Endpunkte für die Suche](/de/enterprise-server@3.19/rest/search/search). Die GraphQL-API verfügt auch über ein benutzerdefiniertes Rate-Limit, das sowohl getrennt von als auch anders berechnet wird als die Rate-Limits in der REST-API. Weitere Informationen finden Sie unter [Ratenbegrenzungen und Abfragegrenzwerte für die GraphQL-API](/de/enterprise-server@3.19/graphql/overview/resource-limitations#rate-limit). Aus diesen Gründen kategorisiert die Antwort der API deine Quotengrenzen. Unter `resources` werden Objekte verschiedener Kategorien angezeigt:

* Das `core`-Objekt stellt deinen Status für die Quotengrenze für alle nicht auf die Suche bezogenen Ressourcen in der REST-API bereit.

* Das `search`-Objekt stellt deinen Status der Quotengrenze für die REST-API für die Suche (mit Ausnahme der Codesuche) bereit. Weitere Informationen finden Sie unter [REST-API-Endpunkte für die Suche](/de/enterprise-server@3.19/rest/search/search).

* Das `code_search`-Objekt stellt deinen Status der Quotengrenze für die REST-API für die Codesuche bereit. Weitere Informationen finden Sie unter [REST-API-Endpunkte für die Suche](/de/enterprise-server@3.19/rest/search/search#search-code).

* Das `graphql`-Objekt stellt deinen Status der Quotengrenze für die GraphQL-API bereit.

* Das `integration_manifest`-Objekt stellt deinen Status der Quotengrenze für den Vorgang `POST /app-manifests/{code}/conversions` bereit. Weitere Informationen finden Sie unter [Registrieren einer GitHub App aus einem Manifest](/de/enterprise-server@3.19/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app-from-a-manifest#3-you-exchange-the-temporary-code-to-retrieve-the-app-configuration).

* Das `dependency_snapshots`-Objekt übergibt den Status Ihrer Ratenbegrenzung zum Übermitteln von Momentaufnahmen an das Abhängigkeitsdiagramm. Weitere Informationen finden Sie unter [REST-API-Endpunkte für das Abhängigkeitsdiagramm](/de/enterprise-server@3.19/rest/dependency-graph).

* Das `code_scanning_upload`-Objekt stellt Ihren Rate-Limit-Status für das Hochladen von SARIF-Ergebnissen zum Code-Scanning bereit. Weitere Informationen finden Sie unter [Hochladen einer SARIF-Datei in GitHub](/de/enterprise-server@3.19/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github).

* Das `actions_runner_registration`-Objekt gibt den Status Ihres Geschwindigkeitslimits für das Registrieren selbstgehosteter Runner in GitHub Actions an. Weitere Informationen finden Sie unter [REST-API-Endpunkte für selbst gehostete Runner](/de/enterprise-server@3.19/rest/actions/self-hosted-runners).

Weitere Informationen zu den Headern und Werten in der Antwort auf die Ratenbegrenzungen findest du unter [Ratenbegrenzungen für die REST-API](/de/enterprise-server@3.19/rest/overview/rate-limits-for-the-rest-api).

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2022-11-28`. Curl examples below omit these standard headers for brevity.

## Get rate limit status for the authenticated user

```
GET /rate_limit
```

Note

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

Some categories of endpoints have custom rate limits that are separate from the rate limit governing the other REST API endpoints. For this reason, the API response categorizes your rate limit. Under resources, you'll see objects relating to different categories:

The core object provides your rate limit status for all non-search-related resources in the REST API.
The search object provides your rate limit status for the REST API for searching (excluding code searches). For more information, see "Search."
The code\_search object provides your rate limit status for the REST API for searching code. For more information, see "Search code."
The graphql object provides your rate limit status for the GraphQL API. For more information, see "Resource limitations."
The integration\_manifest object provides your rate limit status for the POST /app-manifests/{code}/conversions operation. For more information, see "Creating a GitHub App from a manifest."
The dependency\_snapshots object provides your rate limit status for submitting snapshots to the dependency graph. For more information, see "Dependency graph."
The dependency\_sbom object provides your rate limit status for requesting SBOMs from the dependency graph. For more information, see "Dependency graph."
The actions\_runner\_registration object provides your rate limit status for registering self-hosted runners in GitHub Actions. For more information, see "Self-hosted runners."
The source\_import object is no longer in use for any API endpoints, and it will be removed in the next API version. For more information about API versions, see "API Versions."

Note

The rate object is closing down. 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

* **200** - OK

* **304** - Not modified

* **404** - Resource not found

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/rate_limit
```

**Response schema (Status: 200):**

* `resources`: required, object:
  * `core`: required, `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `graphql`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `search`: required, `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `code_search`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `source_import`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `integration_manifest`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `actions_runner_registration`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `scim`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `dependency_sbom`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `code_scanning_autofix`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `copilot_usage_records`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
* `rate`: required, `Rate Limit`:
  * `limit`: required, integer
  * `remaining`: required, integer
  * `reset`: required, integer
  * `used`: required, integer