Modello di URL per l'abuso di report
È possibile che un client crei un URL che può essere usato dall'utente per segnalare abusi su un pacchetto specifico. Ciò è utile quando un'origine del pacchetto vuole consentire a tutte le esperienze client (anche di terze parti) di delegare segnalazioni di abusi all'origine del pacchetto.
La risorsa usata per la compilazione di questo URL è la ReportAbuseUriTemplate
risorsa presente nell'indice del servizio.
Vengono usati i valori seguenti @type
:
Valore @type | Note |
---|---|
ReportAbuseUriTemplate/3.0.0-beta | Versione iniziale |
ReportAbuseUriTemplate/3.0.0-rc | Alias di ReportAbuseUriTemplate/3.0.0-beta |
L'URL per l'API seguente è il valore della @id
proprietà associata a uno dei valori di risorsa indicati in precedenza @type
.
Anche se il client non è destinato a inviare richieste all'URL dell'abuso di report per conto dell'utente, la pagina Web deve supportare il GET
metodo per consentire l'apertura di un URL selezionato in un Web browser.
Dato un ID e una versione noti del pacchetto, l'implementazione client può costruire un URL usato per accedere a un'interfaccia Web. L'implementazione del client deve visualizzare questo URL costruito (o un collegamento selezionabile) all'utente consentendo loro di aprire un Web browser all'URL e di creare eventuali report di abuso necessari. L'implementazione del modulo di segnalazione abusi è determinata dall'implementazione del server.
Il valore di @id
è una stringa URL contenente uno dei token segnaposto seguenti:
Nome | Digita | Obbligatorio | Note |
---|---|---|---|
{id} |
string | no | ID pacchetto per cui segnalare abusi |
{version} |
string | no | Versione del pacchetto per cui segnalare abusi |
I {id}
valori e interpretati dall'implementazione del server devono essere senza distinzione tra maiuscole e {version}
minuscole e non sensibili al fatto che la versione sia normalizzata.
Ad esempio, il modello di abuso di report di nuget.org è simile al seguente:
https://www.nuget.org/packages/{id}/{version}/ReportAbuse
Se l'implementazione del client deve visualizzare un collegamento al modulo di segnalazione abusi per NuGet.Versioning 4.3.0, genera l'URL seguente e lo fornisce all'utente:
https://www.nuget.org/packages/NuGet.Versioning/4.3.0/ReportAbuse