Modello di URL dei dettagli del pacchetto

È possibile che un client crei un URL che può essere usato dall'utente per visualizzare altri dettagli del pacchetto nel Web browser. Ciò è utile quando un'origine del pacchetto vuole visualizzare informazioni aggiuntive su un pacchetto che potrebbe non rientrare nell'ambito dell'applicazione client NuGet.

La risorsa usata per la compilazione di questo URL è la PackageDetailsUriTemplate risorsa presente nell'indice del servizio.

Controllo delle versioni

Vengono usati i valori seguenti @type :

Valore @type	Note
PackageDetailsUriTemplate/5.1.0	Versione iniziale

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 intende effettuare richieste all'URL dei dettagli del pacchetto 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 che consente di aprire un Web browser all'URL e per altre informazioni sul pacchetto. Il contenuto della pagina dei dettagli del pacchetto è determinato dall'implementazione del server.

L'URL deve essere un URL assoluto e lo schema (protocollo) deve essere HTTPS.

Il valore di nell'indice del @id servizio è una stringa URL contenente uno dei token segnaposto seguenti:

Segnaposto URL

Nome	Digita	Obbligatorio	Note
{id}	string	no	ID pacchetto per ottenere i dettagli
{version}	string	no	Versione del pacchetto per ottenere i dettagli per

Il server deve accettare {id} valori e con maiuscole e {version} minuscole. Inoltre, il server non deve essere sensibile al fatto che la versione sia normalizzata. In altre parole, il server deve accettare anche versioni non normalizzate.

Ad esempio, il modello di dettagli del pacchetto nuget.org è simile al seguente:

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

Se l'implementazione client deve visualizzare un collegamento ai dettagli del pacchetto per NuGet.Versioning 4.3.0, genera l'URL seguente e lo specifica all'utente:

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