Condividi tramite

Modello di URL per l'abuso di report

  • Articolo

È 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.

Controllo delle versioni

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

Modello di URL

L'URL per l'API seguente è il valore della @id proprietà associata a uno dei valori di risorsa indicati in precedenza @type .

Metodi HTTP

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.

Costruire l'URL

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:

Segnaposto URL

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