Begrenzung der Bandbreite
Die NuGet.org-API erzwingt die Ratebegrenzung, um Missbrauch zu verhindern. Anforderungen, die den Zinsgrenzwert überschreiten, geben den folgenden Fehler zurück:
{
"statusCode": 429,
"message": "Rate limit is exceeded. Try again in 56 seconds."
}
Neben der Anforderungsdrosselung mithilfe von Ratenbeschränkungen erzwingen einige APIs auch Kontingente. Anforderungen, die das Kontingent überschreiten, geben den folgenden Fehler zurück:
{
"statusCode": 403,
"message": "Quota exceeded."
}
In den folgenden Tabellen sind die Ratenbeschränkungen für die NuGet.org-API aufgeführt.
Hinweis
Es wird empfohlen, die V3-Such-APIs von NuGet.org zu verwenden, da sie derzeit nicht eingeschränkt ist. Für V1- und V2-Such-APIs gelten die folgenden Grenzwerte:
API | Typ des Grenzwerts | Wert des Grenzwerts | API-Anwendungsfall |
---|---|---|---|
GET /api/v1/Packages |
IP | 1000 / Minute | Abfragen von NuGet-Paketmetadaten über die OData-Sammlung Packages v1 |
GET /api/v1/Search() |
IP | 3000 / Minute | Suchen nach NuGet-Paketen über v1 Search-Endpunkt |
GET /api/v2/Packages |
IP | 20000 / Minute | Abfragen von NuGet-Paketmetadaten über die v2 OData-SammlungPackages |
GET /api/v2/Packages/$count |
IP | 100 / Minuten | Abfrage-NuGet-Paketanzahl über die v2 OData Packages -Auflistung |
API | Typ des Grenzwerts | Wert des Grenzwerts | API-Anwendungsfall |
---|---|---|---|
PUT /api/v2/package |
API-Schlüssel | 350 / Stunde | Hochladen eines neuen NuGet-Pakets (Version) über den v2-Pushendpunkt |
DELETE /api/v2/package/{id}/{version} |
API-Schlüssel | 250 / Stunde | Aufheben der Liste eines NuGet-Pakets (Version) über v2-Endpunkt |
Wenn Sie programmgesteuert auf die nuget.org Webseiten zugreifen, sollten Sie unsere dokumentierten V3-APIs untersuchen. Diese Endpunkte ermöglichen einen einfacheren Zugriff auf Paketmetadaten und -inhalte. Die V3-API verfügt über eine bessere Verfügbarkeit und hat eine höhere Leistung als der Zugriff auf die NuGet Gallery-Webseiten, die für die Webbrowserinteraktion entwickelt wurden.
API | Typ des Grenzwerts | Wert des Grenzwerts | API-Anwendungsfall |
---|---|---|---|
GET /package/{id}/{version} |
IP | 50 Minuten | Detailseite des Pakets (Version) anzeigen. |