Vorlage "Missbrauchs-URL melden"
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.
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 |
Die Basis-URL für die folgenden APIs ist der Wert der @id
-Eigenschaft, die einem der oben genannten @type
-Ressourcenwerte zugeordnet ist.
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.
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:
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