Modèle d’URL de détails du package
Il est possible qu’un client crée une URL qui peut être utilisée par l’utilisateur pour afficher plus de détails sur le package dans son navigateur web. Cela est utile lorsqu’une source de package souhaite afficher des informations supplémentaires sur un package qui peut ne pas correspondre à l’étendue de ce que l’application cliente NuGet affiche.
La ressource utilisée pour générer cette URL est la ressource PackageDetailsUriTemplate trouvée dans l’index de service.
Contrôle de version
Les valeurs @type suivantes sont utilisées :
| Valeur @type | Notes |
|---|---|
| PackageDetailsUriTemplate/5.1.0 | La version initiale |
URL template
L’URL de l’API suivante est la valeur de la propriété @id associée à l’une des valeurs de ressource @type mentionnées ci-dessus.
Méthodes HTTP
Bien que le client n’ait pas l’intention d’envoyer des demandes à l’URL des détails du package pour le compte de l’utilisateur, la page web doit prendre en charge la méthode GET pour autoriser l’ouverture facile d’une URL cliquée dans un navigateur web.
Construire l’URL
Étant donné un ID de package et une version connus, l’implémentation du client peut construire une URL utilisée pour accéder à une interface web. L’implémentation du client doit afficher cette URL construite (ou lien cliquable) à l’utilisateur, ce qui lui permet d’ouvrir un navigateur web à l’URL et d’en savoir plus sur le package. Le contenu de la page de détails du package est déterminé par l’implémentation du serveur.
L’URL doit être une URL absolue et le schéma (protocole) doit être HTTPS.
La valeur de l’index @id de service est une chaîne d’URL contenant l’un des jetons d’espace réservé suivants :
Espaces réservés d’URL.
| Nom | Type | Requise | Notes |
|---|---|---|---|
{id} |
string | non | ID de package pour obtenir des détails |
{version} |
string | non | Version du package pour obtenir des détails pour |
Le serveur doit accepter les valeurs {id} et {version} avec n’importe quelle casse. De plus, le serveur ne doit pas être sensible à la normalisation de la version. En d’autres termes, le serveur doit accepter également les versions non normalisées.
Par exemple, le modèle de détails du package nuget.org ressemble à ceci :
https://www.nuget.org/packages/{id}/{version}
Si l’implémentation du client doit afficher un lien vers les détails du package pour NuGet.Versioning 4.3.0, elle produit l’URL suivante et la fournit à l’utilisateur :
https://www.nuget.org/packages/NuGet.Versioning/4.3.0