Freigeben über

Vorlage "Missbrauchs-URL melden"

  • Artikel

Es ist möglich, dass ein Client eine URL erstellt, die vom Benutzer verwendet werden kann, um Missbrauch über ein bestimmtes Paket zu melden. Dies ist nützlich, wenn eine Paketquelle alle Clienterfahrungen (auch Drittanbieter) zum Delegieren von Missbrauchsberichten an die Paketquelle aktivieren möchte.

Die Zum Erstellen dieser URL verwendete Ressource ist die ReportAbuseUriTemplate Ressource im Dienstindex.

Versionsverwaltung

Die folgenden @type-Werte werden verwendet:

Wert vom Typ @type Hinweise
ReportAbuseUriTemplate/3.0.0-beta Erstrelease
ReportAbuseUriTemplate/3.0.0-rc Alias von ReportAbuseUriTemplate/3.0.0-beta

URL-Vorlage

Die Basis-URL für die folgenden APIs ist der Wert der @id-Eigenschaft, die einem der oben genannten @type-Ressourcenwerte zugeordnet ist.

HTTP-Methoden

Obwohl der Client nicht beabsichtigt ist, Anfragen an die Url des Berichtsmissbrauchs im Namen des Benutzers zu senden, sollte die Webseite die GET Methode unterstützen, um eine geklickte URL einfach in einem Webbrowser zu öffnen.

Erstellen der URL

Angesichts einer bekannten Paket-ID und -Version kann die Clientimplementierung eine URL erstellen, die für den Zugriff auf eine Webschnittstelle verwendet wird. Die Clientimplementierung sollte diese konstruierte URL (oder klickbare Verknüpfung) für den Benutzer anzeigen, sodass er einen Webbrowser mit der URL öffnen und einen erforderlichen Missbrauchsbericht erstellen kann. Die Implementierung des Missbrauchsberichtsformulars wird durch die Serverimplementierung bestimmt.

Der Wert der @id Zeichenfolge ist eine URL-Zeichenfolge, die eines der folgenden Platzhaltertoken enthält:

Sie verwenden URL-Platzhalter

Name Type Erforderlich Notizen
{id} Zeichenfolge Nein Die Paket-ID zum Melden von Missbrauch für
{version} Zeichenfolge Nein Die Paket-Version zum Melden von Missbrauch für

Bei den von der Serverimplementierung interpretierten Werten {id} und {version} muss die Groß-/Kleinschreibung nicht beachtet werden und nicht beachtet werden, ob die Version normalisiert ist.

So sieht z. B. die Berichtsmissbrauchsvorlage von nuget.org wie folgt aus:

https://www.nuget.org/packages/{id}/{version}/ReportAbuse

Wenn die Clientimplementierung einen Link zum Berichtsmissbrauchsformular für NuGet.Versioning 4.3.0 anzeigen muss, wird die folgende URL erstellt und dem Benutzer bereitgestellt:

https://www.nuget.org/packages/NuGet.Versioning/4.3.0/ReportAbuse