Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revise translations #7

Merged
merged 5 commits into from
Nov 2, 2018
Merged

Revise translations #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fd800c6
Revise translations
iw0nderhow Oct 29, 2018
001732b
LM Feedback
LisandroSu Nov 2, 2018
6aff9ef
Break line fix
LisandroSu Nov 2, 2018
ac99fb9
LM Feedback
LisandroSu Nov 2, 2018
8a13076
LM Feedback
LisandroSu Nov 2, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 32 additions & 32 deletions docs/api/NuGet-Protocols.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "\"NuGet.org\"-Protokolle"
description: Der sich entwickelnden "nuget.org"-Protokolle für die Interaktion mit NuGet-Clients.
title: "\"nuget.org\"-Protokolle"
description: Die sich entwickelnden Protokolle bei nuget.org für die Interaktion mit NuGet-Clients.
author: anangaur
ms.author: anangaur
ms.date: 10/30/2017
Expand All @@ -13,48 +13,48 @@ ms.contentlocale: de-DE
ms.lasthandoff: 09/04/2018
ms.locfileid: "43547272"
---
# <a name="nugetorg-protocols"></a>"NuGet.org"-Protokolle
# <a name="nugetorg-protocols"></a>nuget.org-Protokolle

Zum interagieren mit nuget.org müssen Sie bestimmte Protokolle zu folgen. Da diese Protokolle Weiterentwicklung zu halten, müssen Clients die Version des Protokolls identifizieren nutzen, wenn bestimmte nuget.org APIs aufrufen. Dadurch wird ein "NuGet.org", um die Änderungen auf eine nicht unterbrechende Weise eingeführt werden, für die alten Clients.
Zum Interagieren mit nuget.org müssen Clients bestimmte Protokolle nutzen. Da diese Protokolle sich immer weiterentwickeln, müssen Clients die von ihnen genutzte Protokollversion angeben, wenn sie bestimmte nuget.org-APIs aufrufen. Dadurch kann nuget.org Änderungen einführen und mit alten Clients kompatibel bleiben.

> [!Note]
> Auf dieser Seite dokumentierten APIs beziehen sich auf nuget.org aus, und es gibt keine Erwartungen an andere NuGet-Server-Implementierungen diese APIs einführen.
> Die hier dokumentierten APIs sind spezifisch für nuget.org, und es wird von anderen NuGet-Serverimplementierungen nicht erwartet, dass sie diese APIs einführen.

Weitere Informationen über die NuGet-API, die allgemein für die NuGet-Ökosystem implementiert, finden Sie unter den [-API – Übersicht](overview.md).
Weitere Informationen zur NuGet-API, die im NuGet-Ökosystem weitgehend implementiert ist, finden Sie in der [API-Übersicht](overview.md).

Dieses Thema enthält verschiedene Protokolle wie und wann sie zu Vorhandensein stammen.
Dieses Thema listet verschiedene Protokolle auf, sobald diese eingeführt werden.

## <a name="nuget-protocol-version-410"></a>NuGet Protocol, Version 4.1.0
## <a name="nuget-protocol-version-410"></a>NuGet-Protokoll, Version 4.1.0

Die 4.1.0 Protokoll gibt an, die Nutzung der überprüfen-Scope-Schlüssel für die Interaktion mit anderen Diensten als "NuGet.org", um ein Paket mit einem nuget.org-Konto zu überprüfen. Beachten Sie, dass die `4.1.0` Version ist eine nicht transparente Zeichenfolge wurden jedoch zufällig mit der ersten Version des offiziellen NuGet-Clients übereinstimmen, die dieses Protokoll unterstützt.

Überprüfung wird sichergestellt, dass der Benutzer erstellte API-Schlüssel werden nur mit nuget.org verwendet, und diese anderen der Überprüfung oder der Überprüfung von einem Drittanbieter-Dienst über eine einmalige Verwendung überprüfen-Scope-Schlüssel erfolgt. Diese überprüfen-Scope-Schlüssel können verwendet werden, um sicherzustellen, dass das Paket an einen bestimmten Benutzer (Konto), die auf nuget.org gehört.

### <a name="client-requirement"></a>Client-Anforderung

Clients müssen die folgenden Header übergeben werden soll, wenn sie API-Aufrufen **Push** Pakete auf nuget.org:
Clients müssen die folgenden Header übergeben, wenn sie einen API-Aufruf abgeben, um Pakete auf nuget.org **hochzuladen**:

X-NuGet-Protocol-Version: 4.1.0

Beachten Sie, dass die `X-NuGet-Client-Version` Header weist eine ähnliche Semantik, sondern wird reserviert, um nur von der offiziellen NuGet-Client verwendet werden. Clients von Drittanbietern verwenden, sollten die `X-NuGet-Protocol-Version` Header und Wert.
Beachten Sie, dass der Header `X-NuGet-Client-Version` eine ähnliche Semantik benutzt, aber für die ausschließliche Nutzung durch den offiziellen NuGet-Client vorgesehen ist. Clients von Drittanbietern sollten den Header und Wert `X-NuGet-Protocol-Version` nutzen.

Die **Push** Protokoll selbst wird beschrieben, in der Dokumentation für die [ `PackagePublish` Ressource](package-publish-resource.md).
Das **Push**-Protokoll selbst wird in der Dokumentation für die [`PackagePublish`-Ressource](package-publish-resource.md) beschrieben.

Wenn ein Client mit externen Diensten und Anforderungen interagiert zu prüfen, ob ein Paket zu einem bestimmten Benutzer (Konto) gehört, muss das folgende Protokoll verwenden und überprüfen-Scope-Schlüssel und nicht die API-Schlüssel von nuget.org verwenden.
Wenn ein Client mit externen Diensten und Anforderungen interagiert und überprüfen muss, ob ein Paket einem bestimmten Benutzer (Konto) gehört, sollte er das folgende Protokoll und die "Verify Scope"-Schlüssel, nicht die API-Schlüssel von nuget.org, verwenden.

### <a name="api-to-request-a-verify-scope-key"></a>-API, um einen Bereich überprüfen Schlüssel anfordern
### <a name="api-to-request-a-verify-scope-key"></a>API, um einen "Verify Scope"-Schlüssel anzufordern

Abrufen eines Schlüssels überprüfen-Bereich für den Autor eines "NuGet.org", um ein Paket, das im Besitz von eines Gastbenutzers zu überprüfen, wird diese API verwendet.
Diese API wird genutzt, um einen "Verify Scope"-Schlüssel anzufordern, damit ein nuget.org-Autor ein Paket validieren kann, das ihm/ihr gehört.

POST api/v2/package/create-verification-key/{ID}/{VERSION}

#### <a name="request-parameters"></a>Anforderungsparameter

name | In | Typ | Erforderlich | Hinweise
-------------- | ------ | ------ | -------- | -----
Id | URL | Zeichenfolge | ja | Die Paket-Identidier für die der Schlüssel des überprüfen Bereich angefordert wird
VERSION | URL | Zeichenfolge | Nein | Die Paketversion
X-NuGet-ApiKey | Header | Zeichenfolge | ja | Beispiel: `X-NuGet-ApiKey: {USER_API_KEY}`
Name | In | Typ | Erforderlich | Hinweise
-------------- | ------ | ------ | ------------ | --------
ID | URL | String | ja | Die Paket-ID, für die der Schlüssel angefordert wird
VERSION | URL | String | nein | Die Paketversion
X-NuGet-ApiKey | Header | String | ja | Beispiel: `X-NuGet-ApiKey: {USER_API_KEY}`

#### <a name="response"></a>Antwort

Expand All @@ -65,27 +65,27 @@ X-NuGet-ApiKey | Header | Zeichenfolge | ja | Beispiel: `X-NuGet-ApiKey: {U
}
```

### <a name="api-to-verify-the-verify-scope-key"></a>API, um zu überprüfen, ob den Schlüssel der überprüfen-Bereich
### <a name="api-to-verify-the-verify-scope-key"></a>API, um den "Verify Scope"-Schlüssel zu überprüfen

Diese API wird verwendet, um überprüfen-Scope-Schlüssel für der Autor von "NuGet.org" gehörige Paket zu überprüfen.
Diese API wird verwendet, um einen "Verify Scope"-Schlüssel für ein Paket zu überprüfen.

GET api/v2/verifykey/{ID}/{VERSION}

#### <a name="request-parameters"></a>Anforderungsparameter

name | In | Typ | Erforderlich | Hinweise
------------- | ------ | ------ | -------- | -----
Id | URL | Zeichenfolge | ja | Die Paket-ID für die der Schlüssel des überprüfen Bereich angefordert wird
VERSION | URL | Zeichenfolge | Nein | Die Paketversion
X-NuGet-ApiKey | Header | Zeichenfolge | ja | Beispiel: `X-NuGet-ApiKey: {VERIFY_SCOPE_KEY}`
Name | In | Typ | Erforderlich | Hinweise
------------- | ------ | ------ | ------------ | --------
ID | URL | String | ja | Die Paket-ID, für die der "Verify Scope"-Schlüssel angefordert wird
VERSION | URL | String | nein | Die Paketversion
X-NuGet-ApiKey | Header | String | ja | beispielsweise `X-NuGet-ApiKey: {VERIFY_SCOPE_KEY}`

> [!Note]
> Dieser Bereich API-Schlüssel stellen Sie sicher, die in einen ganzen Tag läuft ab, oder bei der ersten Verwendung, welcher Fall zuerst eintritt.
> Dieser "Verify Scope"-Schlüssel läuft nach einem Tag oder der ersten Nutzung ab.

#### <a name="response"></a>Antwort

Statuscode | Bedeutung
----------- | -------
300 | Der API-Schlüssel ist gültig.
403 | Die API-Schlüssel ist ungültig oder nicht autorisiert, für das Paket mithilfe von Push übertragen
404 | Das Paket verweist `ID` und `VERSION` (optional) ist nicht vorhanden
Statuscode | Bedeutung
----------- | ---------
200 | Der API-Schlüssel ist gültig.
403 | Der API-Schlüssel ist ungültig oder für dieses Paket nicht autorisiert
404 | Das Paket, das mit `ID` und (optional) `VERSION` angegeben wurde, existiert nicht
Loading