Paket ayrıntıları URL şablonu
İstemcinin, web tarayıcısında daha fazla paket ayrıntısı görmek için kullanıcı tarafından kullanılabilecek bir URL oluşturması mümkündür. Bu, bir paket kaynağı NuGet istemci uygulamasının gösterdiği kapsama sığmayabilecek bir paket hakkında ek bilgi göstermek istediğinde kullanışlıdır.
Bu URL'yi oluşturmak için kullanılan kaynak, hizmet dizininde bulunan kaynaktırPackageDetailsUriTemplate.
Sürüm oluşturma
Aşağıdaki @type değerler kullanılır:
| @type Değer | Notlar |
|---|---|
| PackageDetailsUriTemplate/5.1.0 | İlk sürüm |
URL şablonu
Aşağıdaki API'nin URL'si, yukarıda belirtilen kaynak @type değerlerinden biriyle ilişkili özelliğin değeridir@id.
HTTP yöntemleri
İstemci, kullanıcı adına paket ayrıntıları URL'sine istekte bulunmaya yönelik olmasa da, web sayfası tıklanan URL'nin web tarayıcısında kolayca açılmasına izin vermek için yöntemini desteklemelidir GET .
URL'yi oluşturma
Bilinen bir paket kimliği ve sürümü göz önünde bulundurulduğunda, istemci uygulaması bir web arabirimine erişmek için kullanılan bir URL oluşturabilir. İstemci uygulaması, kullanıcının URL'ye bir web tarayıcısı açmasına ve paket hakkında daha fazla bilgi edinebilmesine olanak sağlayan bu oluşturulmuş URL'yi (veya tıklanabilir bağlantıyı) görüntülemelidir. Paket ayrıntıları sayfasının içeriği sunucu uygulaması tarafından belirlenir.
URL mutlak bir URL olmalı ve şema (protokol) HTTPS olmalıdır.
hizmet dizinindeki değerinin değeri @id , aşağıdaki yer tutucu belirteçlerden herhangi birini içeren bir URL dizesidir:
URL yer tutucuları
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
{id} |
Dize | hayır | Ayrıntılarını almak için paket kimliği |
{version} |
Dize | hayır | Ayrıntılarını almak için paket sürümü |
Sunucu herhangi bir büyük/küçük harfle ve {version} değerlerini kabul {id} etmelidir. Ayrıca, sunucu sürümün normalleştirilip normalleştirilmediğine duyarlı olmamalıdır. Başka bir deyişle, sunucu normalleştirilmemiş sürümleri de kabul etmelidir.
Örneğin, nuget.org'un paket ayrıntıları şablonu şöyle görünür:
https://www.nuget.org/packages/{id}/{version}
İstemci uygulamasının NuGet.Versioning 4.3.0 için paket ayrıntılarına bir bağlantı görüntülemesi gerekiyorsa, aşağıdaki URL'yi oluşturur ve kullanıcıya sağlar:
https://www.nuget.org/packages/NuGet.Versioning/4.3.0