Paket meta verileri
NuGet V3 API'sini kullanarak bir paket kaynağında bulunan paketler hakkında meta veriler getirmek mümkündür. Bu meta veriler hizmet dizininde bulunan kaynak kullanılarak RegistrationsBaseUrl getirilebilir.
altında RegistrationsBaseUrl bulunan belgelerin koleksiyonu genellikle "kayıtlar" veya "kayıt blobları" olarak adlandırılır. Tek RegistrationsBaseUrl bir altındaki belge kümesine "kayıt kovanı" denir. Kayıt kovanı, bir paket kaynağında bulunan her paketle ilgili meta veriler içerir.
Not
Paket meta veri kaynağı, paketler için tüm meta verileri içermez. Paketlerin sahiplerini, indirmelerini veya ön ek rezervasyon durumunu bulmak için arama kaynağını kullanın.
Sürüm oluşturma
Aşağıdaki @type değerler kullanılır:
| @type Değer | Notlar |
|---|---|
| RegistrationsBaseUrl | İlk sürüm |
| KayıtlarBaseUrl/3.0.0-beta | Diğer adı RegistrationsBaseUrl |
| RegistrationsBaseUrl/3.0.0-rc | Diğer adı RegistrationsBaseUrl |
| KayıtlarBaseUrl/3.4.0 | Sıkıştırılmış yanıtlar |
| RegistrationsBaseUrl/3.6.0 | SemVer 2.0.0 paketlerini içerir |
Bu, çeşitli istemci sürümleri için kullanılabilen üç ayrı kayıt kovanlarını temsil eder.
RegistrationsBaseUrl
Bu kayıtlar sıkıştırılmaz (örtük Content-Encoding: identitybir kullanırlar). SemVer 2.0.0 paketleri bu kovanın dışında tutulur .
KayıtlarBaseUrl/3.4.0
Bu kayıtlar kullanılarak Content-Encoding: gzipsıkıştırılır. SemVer 2.0.0 paketleri bu kovanın dışında tutulur .
RegistrationsBaseUrl/3.6.0
Bu kayıtlar kullanılarak Content-Encoding: gzipsıkıştırılır. SemVer 2.0.0 paketleri bu kovana dahil edilir.
SemVer 2.0.0 hakkında daha fazla bilgi için bkz . nuget.org için SemVer 2.0.0 desteği.
Temel URL
Aşağıdaki API'lerin temel URL'si, yukarıda belirtilen kaynak @type değerleriyle ilişkili özelliğin değeridir@id. Aşağıdaki belgede yer tutucu temel URL'si {@id} kullanılacaktır. Temel URL, paket kaynağındaki uygulama veya altyapı değişikliklerine göre değişebilir, bu nedenle istemci yazılımı tarafından hizmet dizininden dinamik olarak getirilmesi gerekir.
HTTP yöntemleri
Kayıt kaynağında bulunan tüm URL'ler ve HEADHTTP yöntemlerini desteklerGET.
Kayıt dizini
Kayıt kaynağı, paket meta verilerini paket kimliğine göre gruplandırr. Aynı anda birden fazla paket kimliği hakkında veri almak mümkün değildir. Bu kaynak, paket kimliklerini bulmanın hiçbir yolunu sağlamaz. Bunun yerine istemcinin istenen paket kimliğini zaten bildiği varsayılır. Her paket sürümüyle ilgili kullanılabilir meta veriler sunucu uygulamasına göre değişir. Paket kayıt blobları aşağıdaki hiyerarşik yapıya sahiptir:
- Dizin: Aynı paket kimliğine sahip bir kaynak üzerindeki tüm paketler tarafından paylaşılan paket meta verilerinin giriş noktası.
- Sayfa: Paket sürümlerini gruplandırma. Sayfadaki paket sürümlerinin sayısı sunucu uygulaması tarafından tanımlanır.
- Yaprak: Tek bir paket sürümüne özgü bir belge.
Kayıt dizininin URL'si tahmin edilebilir ve istemci tarafından paket kimliği ve hizmet dizininden kayıt kaynağının @id değeri verildiğinde belirlenebilir. Kayıt sayfaları ve yapraklarının URL'leri, kayıt dizini incelenerek bulunur.
Kayıt sayfaları ve yaprakları
Bir sunucu uygulamasının kayıt yapraklarını ayrı kayıt sayfası belgelerinde depolaması kesinlikle gerekli olmasa da, istemci tarafı belleğinin korunması önerilir. Tüm kayıt yapraklarını dizinde satır içine almak veya sayfa belgelerinde yaprakları hemen depolamak yerine, sunucu uygulamasının paket sürümlerinin sayısına veya paket yapraklarının kümülatif boyutuna göre iki yaklaşım arasında seçim yapmak için bazı buluşsal yöntemler tanımlaması önerilir.
Tüm paket sürümlerinin (yapraklar) kayıt dizininde depolanması, paket meta verilerini getirmek için gereken HTTP isteklerinin sayısını kaydeder, ancak daha büyük bir belgenin indirilmesi ve daha fazla istemci belleğinin ayrılması gerektiği anlamına gelir. Öte yandan, sunucu uygulaması kayıt yapraklarını hemen ayrı sayfa belgelerinde depolarsa, istemcinin ihtiyaç duyduğu bilgileri almak için daha fazla HTTP isteği gerçekleştirmesi gerekir.
nuget.org kullandığı buluşsal yöntem şu şekildedir: Bir paketin 128 veya daha fazla sürümü varsa, yaprakları 64 boyutlu sayfalara bölün. 128'den az sürüm varsa, satır içi tüm sürümler kayıt dizinine ayrılır. Bunun, 65 -127 sürümleri olan paketlerin dizinde iki sayfası olacağı ancak her iki sayfanın da satır içi olacağı anlamına geldiğini unutmayın.
GET {@id}/{LOWER_ID}/index.json
İstek parametreleri
| Veri Akışı Adı | İçinde | Type | Zorunlu | Notlar |
|---|---|---|---|---|
| LOWER_ID | URL | Dize | evet | Küçük harfle belirtilen paket kimliği |
LOWER_ID değeri, tarafından uygulanan kurallar kullanılarak küçük harfe dönüştürülen istenen paket kimliğidir. NET'in System.String.ToLowerInvariant() yöntemi.
Response
Yanıt, aşağıdaki özelliklere sahip bir kök nesnesi olan bir JSON belgesidir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| count | integer | evet | Dizindeki kayıt sayfalarının sayısı |
| öğe | nesne dizisi | evet | Kayıt sayfaları dizisi |
Dizin nesnesinin items dizisindeki her öğe, kayıt sayfasını temsil eden bir JSON nesnesidir.
Kayıt sayfası nesnesi
Kayıt dizininde bulunan kayıt sayfası nesnesi aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| @id | string | evet | Kayıt sayfasının URL'si |
| count | integer | evet | Sayfadan ayrılan kayıt sayısı |
| öğe | nesne dizisi | hayır | Kayıt dizisi bırakır ve bunların ilişkili meta verileri |
| Alt | string | evet | Sayfadaki en düşük SemVer 2.0.0 sürümü (dahil) |
| ana | Dize | hayır | Kayıt dizininin URL'si |
| Üst | string | evet | Sayfadaki en yüksek SemVer 2.0.0 sürümü (dahil) |
lower Sayfa nesnesinin ve upper sınırları, belirli bir sayfa sürümü için meta veriler gerektiğinde kullanışlıdır.
Bu sınırlar, gereken tek kayıt sayfasını getirmek için kullanılabilir. Sürüm dizeleri NuGet'in sürüm kurallarına uyar. Sürüm dizeleri normalleştirilir ve derleme meta verilerini içermez. NuGet ekosistemindeki tüm sürümlerde olduğu gibi, sürüm dizelerinin karşılaştırması SemVer 2.0.0'ın sürüm önceliği kuralları kullanılarak uygulanır.
parent özelliği yalnızca kayıt sayfası nesnesi özelliğine items sahipse görüntülenir.
items Özellik kayıt sayfası nesnesinde yoksa, içinde belirtilen @id URL tek tek paket sürümleriyle ilgili meta verileri getirmek için kullanılmalıdır. Dizi items bazen sayfa nesnesinden iyileştirme olarak dışlanır. Tek bir paket kimliğinin sürümlerinin sayısı çok büyükse, kayıt dizini belgesi yalnızca belirli bir sürümü veya küçük bir sürüm aralığını önemseyen bir istemci için işlenmek üzere çok büyük ve boşa harcanacaktır.
Özellik mevcutsa items , @id tüm sayfa verileri özelliğinde zaten çizili olduğundan özelliğin items kullanılmaması gerektiğini unutmayın.
Sayfa nesnesinin items dizisindeki her öğe, bir kayıt yaprağını temsil eden bir JSON nesnesidir ve ilişkili meta verilerdir.
Bir sayfada kayıt yaprak nesnesi
Kayıt sayfasında bulunan kayıt yaprağı nesnesi aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| @id | string | evet | Kayıt yaprağının URL'si |
| catalogEntry | nesne | evet | Paket meta verilerini içeren katalog girdisi |
| packageContent | string | evet | Paket içeriğinin URL'si (.nupkg) |
Her kayıt yaprak nesnesi tek bir paket sürümüyle ilişkili verileri temsil eder.
Katalog girdisi
catalogEntry Kayıt yaprağı nesnesindeki özelliği aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| @id | string | evet | Bu nesneyi üretmek için kullanılan belgenin URL'si |
| Yazar | dize veya dize dizisi | hayır | |
| dependencyGroups | nesne dizisi | hayır | Paketin hedef çerçeveye göre gruplandırılmış bağımlılıkları |
| Kaldırılması | nesne | hayır | Paketle ilişkili kullanımdan kaldırma |
| açıklama | Dize | hayır | |
| iconUrl | Dize | hayır | |
| id | string | evet | Paketin kimliği |
| dil | Dize | hayır | |
| licenseUrl | Dize | hayır | |
| licenseExpression | Dize | hayır | |
| listelenen | boolean | hayır | Yoksa listelenmiş olarak düşünülmelidir |
| minClientVersion | Dize | hayır | |
| packageContent | Dize | hayır | Yalnızca eski nedenlerle dahil edilen üst nesnede aynı özelliğin yinelenme |
| projectUrl | Dize | hayır | |
| Yayınlanan | Dize | hayır | Paketin ne zaman yayımlandığına ilişkin ISO 8601 zaman damgasını içeren bir dize |
| readmeUrl | Dize | hayır | PAKET BENİOKU'nun işlenmiş (HTML web sayfası) görünümü için url |
| requireLicenseAcceptance | boolean | hayır | |
| Özet | Dize | hayır | |
| tags | dize veya dize dizisi | hayır | |
| Başlık | Dize | hayır | |
| sürüm | string | evet | Normalleştirmeden sonraki tam sürüm dizesi |
| Güvenlik açıkları | nesne dizisi | hayır | Paketin güvenlik açıkları |
Package version özelliği, normalleştirmeden sonraki tam sürüm dizesidir. Bu, SemVer 2.0.0 derleme verilerinin buraya dahil edilebileceği anlamına gelir.
dependencyGroups özelliği, paketin bağımlılıklarını temsil eden ve hedef çerçeveye göre gruplandırılmış bir nesne dizisidir. Pakette bağımlılık yoksa özelliği eksik, dependencyGroups boş bir dizi veya dependencies tüm grupların özelliği boş veya eksik.
özelliğinin licenseExpression değeri NuGet lisans ifadesi söz dizimiyle uyumlu.
Not
nuget.org,paket published listelenmemiş olduğunda değer 1900 yılına ayarlanır.
Paket bağımlılık grubu
Her bağımlılık grubu nesnesi aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| targetFramework | Dize | hayır | Bu bağımlılıkların uygulanabilecek hedef çerçeve |
| bağımlılıklar | nesne dizisi | hayır |
Dize, targetFramework NuGet'in .NET kitaplığı NuGet.Frameworks tarafından uygulanan biçimi kullanır. Belirtilmezse targetFramework , bağımlılık grubu tüm hedef çerçeveler için geçerlidir.
dependencies özelliği, her biri geçerli paketin paket bağımlılığını temsil eden bir nesne dizisidir.
Paket bağımlılığı
Her paket bağımlılığı aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| id | string | evet | Paket bağımlılığının kimliği |
| aralık | nesne | hayır | Bağımlılığın izin verilen sürüm aralığı |
| kayıt | Dize | hayır | Bu bağımlılık için kayıt dizininin URL'si |
range Özellik dışlanmışsa veya boş bir dizeyse, istemci varsayılan olarak sürüm aralığına (, )sahip olmalıdır. Başka bir ifadeyle, bağımlılığın herhangi bir sürümüne izin verilir. özelliği için range değerine * izin verilmiyor.
Paketi kullanımdan kaldırma
Her paketin kullanımdan kaldırılması aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| Sebep | dizeler dizisi | evet | Paketin kullanım dışı olmasının nedenleri |
| ileti | Dize | hayır | Bu kullanımdan kaldırma hakkındaki ek ayrıntılar |
| alternatePackage | nesne | hayır | Bunun yerine kullanılması gereken alternatif paket |
reasons özelliği en az bir dize içermeli ve yalnızca aşağıdaki tabloda yer alan dizeleri içermelidir:
| Neden | Açıklama |
|---|---|
| Eski | Paket artık korunmaz |
| CriticalBugs | Pakette kullanım için uygun olmayan hatalar var |
| Diğer | Paket, bu listede bulunmayan bir nedenden dolayı kullanım dışı bırakıldı |
reasons özelliği bilinen kümeden olmayan dizeler içeriyorsa, bunlar yoksayılmalıdır. Dizeler büyük/küçük harfe duyarlı değildir, bu nedenle legacy ile Legacyaynı şekilde ele alınmalıdır. Dizide sıralama kısıtlaması yoktur, bu nedenle dizeler herhangi bir rastgele düzende düzenlenebilir. Ayrıca, özelliği yalnızca bilinen kümeden olmayan dizeler içeriyorsa, yalnızca "Diğer" dizesini içeriyor gibi kabul edilmelidir.
Alternatif paket
Alternatif paket nesnesi aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| id | string | evet | Alternatif paketin kimliği |
| aralık | nesne | hayır | İzin verilen sürüm aralığı veya * herhangi bir sürüme izin verilip verilmediğini |
Güvenlik Açıkları
Bir nesne dizisi vulnerability . Her güvenlik açığı aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| advisoryUrl | string | evet | Paket için güvenlik önerisinin konumu |
| önem derecesi | string | evet | Danışmanlığın önem derecesi: "0" = Düşük, "1" = Orta, "2" = Yüksek, "3" = Kritik |
Örnek isteği
GET https://api.nuget.org/v3/registration-sample/nuget.server.core/index.json
Temel URL bölümünde belirtildiği gibi hizmet dizininden temel URL'yi (https://api.nuget.org/v3/registration-sample/bu örnekte) getirdiğinizden emin olun.
Örnek yanıt
{
"count": 1,
"items": [
{
"@id": "https://api.nuget.org/v3/registration-sample/nuget.server.core/index.json#page/3.0.0-beta/3.0.0-beta",
"count": 1,
"items": [
{
"@id": "https://api.nuget.org/v3/registration-sample/nuget.server.core/3.0.0-beta.json",
"catalogEntry": {
"@id": "https://api.nuget.org/v3/catalog0/data/2017.10.05.18.41.33/nuget.server.core.3.0.0-beta.json",
"authors": ".NET Foundation",
"dependencyGroups": [
{
"@id": "https://api.nuget.org/v3/catalog0/data/2017.10.05.18.41.33/nuget.server.core.3.0.0-beta.json#dependencygroup",
"dependencies": [
{
"@id": "https://api.nuget.org/v3/catalog0/data/2017.10.05.18.41.33/nuget.server.core.3.0.0-beta.json#dependencygroup/nuget.core",
"id": "NuGet.Core",
"range": "[2.14.0, )",
"registration": "https://api.nuget.org/v3/registration-sample/nuget.core/index.json"
}
]
}
],
"description": "Core library for creating a Web Application used to host a simple NuGet feed",
"iconUrl": "",
"id": "NuGet.Server.Core",
"language": "",
"licenseUrl": "https://raw.githubusercontent.com/NuGet/NuGet.Server/dev/LICENSE.txt",
"listed": true,
"minClientVersion": "2.6",
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.server.core/3.0.0-beta/nuget.server.core.3.0.0-beta.nupkg",
"projectUrl": "https://github.com/NuGet/NuGet.Server",
"published": "2017-10-05T18:40:32.43+00:00",
"requireLicenseAcceptance": false,
"summary": "",
"tags": [ "" ],
"title": "",
"version": "3.0.0-beta",
"vulnerabilities": [
{
"advisoryUrl": "https://github.com/advisories/ABCD-1234-5678-9012",
"severity": "2"
}
]
},
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.server.core/3.0.0-beta/nuget.server.core.3.0.0-beta.nupkg",
"registration": "https://api.nuget.org/v3/registration-sample/nuget.server.core/index.json"
}
],
"lower": "3.0.0-beta",
"upper": "3.0.0-beta"
}
]
}
Bu özel durumda, kayıt dizininde kayıt sayfası satır içine alınmıştır, bu nedenle tek tek paket sürümleriyle ilgili meta verileri getirmek için ek istek gerekmez.
Kayıt sayfası
Kayıt sayfasında kayıt yaprakları bulunur. Kayıt sayfası getirme URL'si, yukarıda bahsedilen kayıt sayfası nesnesindeki özelliği tarafından @id belirlenir. URL'nin tahmin edilebilir olması amaçlanmamıştır ve her zaman dizin belgesi yoluyla bulunmalıdır.
Uyarı
nuget.org kayıt sayfası belgesinin URL'si tesadüfen sayfanın alt ve üst sınırlarını içerir. Ancak, dizin belgesinde geçerli bir bağlantı olduğu sürece sunucu uygulamaları URL'nin şeklini değiştirmekte serbest olduğundan bu varsayım hiçbir zaman istemci tarafından yapılmamalıdır.
items Dizi kayıt dizininde sağlanmadığında, değerin @id HTTP GET isteği, kök olarak nesnesi olan bir JSON belgesi döndürür. Nesnesi aşağıdaki özelliklere sahiptir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| @id | string | evet | Kayıt sayfasının URL'si |
| count | integer | evet | Sayfadan ayrılan kayıt sayısı |
| öğe | nesne dizisi | evet | Kayıt dizisi bırakır ve bunların ilişkili meta verileri |
| Alt | string | evet | Sayfadaki en düşük SemVer 2.0.0 sürümü (dahil) |
| ana | string | evet | Kayıt dizininin URL'si |
| Üst | string | evet | Sayfadaki en yüksek SemVer 2.0.0 sürümü (dahil) |
Kayıt yaprağı nesnelerinin şekli yukarıdaki kayıt dizinindekiyle aynıdır.
Örnek isteği
GET https://api.nuget.org/v3/registration-sample/ravendb.client/page/1.0.531/1.0.729-unstable.json
Temel URL bölümünde belirtildiği gibi hizmet dizininden temel URL'yi (https://api.nuget.org/v3/registration-sample/bu örnekte) getirdiğinizden emin olun.
Örnek yanıt
{
"count": 2,
"lower": "1.0.531",
"parent": "https://api.nuget.org/v3/registration-sample/nuget.protocol.v3.example/index.json",
"upper": "1.0.729-unstable",
"items": [
{
"@id": "https://api.nuget.org/v3/registration-sample/nuget.protocol.v3.example/1.0.531.json",
"@type": "Package",
"commitId": "e0b9ca79-75b5-414f-9e3e-de9534b5cfd1",
"commitTimeStamp": "2017-10-26T14:12:19.3439088Z",
"catalogEntry": {
"@id": "https://api.nuget.org/v3/catalog0/data/2015.02.01.11.38.37/nuget.protocol.v3.example.1.0.531.json",
"@type": "PackageDetails",
"authors": "NuGet.org Team",
"iconUrl": "https://www.nuget.org/Content/gallery/img/default-package-icon.svg",
"id": "NuGet.Protocol.V3.Example",
"licenseUrl": "http://www.opensource.org/licenses/ms-pl",
"listed": false,
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.protocol.v3.example/1.0.531/nuget.protocol.v3.example.1.0.531.nupkg",
"projectUrl": "https://github.com/NuGet/NuGetGallery",
"published": "1900-01-01T00:00:00+00:00",
"requireLicenseAcceptance": true,
"title": "NuGet V3 Protocol Example",
"version": "1.0.531"
},
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.protocol.v3.example/1.0.531/nuget.protocol.v3.example.1.0.531.nupkg",
"registration": "https://api.nuget.org/v3/registration-sample/nuget.protocol.v3.example/index.json"
},
{
"@id": "https://api.nuget.org/v3/registration-sample/nuget.protocol.v3.example/1.0.729-unstable.json",
"@type": "Package",
"commitId": "e0b9ca79-75b5-414f-9e3e-de9534b5cfd1",
"commitTimeStamp": "2017-10-26T14:12:19.3439088Z",
"catalogEntry": {
"@id": "https://api.nuget.org/v3/catalog0/data/2015.02.01.18.22.05/nuget.protocol.v3.example.1.0.729-unstable.json",
"@type": "PackageDetails",
"authors": "NuGet.org Team",
"deprecation": {
"reasons": [
"CriticalBugs"
],
"message": "This package is unstable and broken!",
"alternatePackage": {
"id": "Newtonsoft.JSON",
"range": "12.0.2"
}
},
"iconUrl": "https://www.nuget.org/Content/gallery/img/default-package-icon.svg",
"id": "NuGet.Protocol.V3.Example",
"licenseUrl": "http://www.opensource.org/licenses/ms-pl",
"listed": false,
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.protocol.v3.example/1.0.729-unstable/nuget.protocol.v3.example.1.0.729-unstable.nupkg",
"projectUrl": "https://github.com/NuGet/NuGetGallery",
"published": "1900-01-01T00:00:00+00:00",
"requireLicenseAcceptance": true,
"summary": "This package is an example for the V3 protocol.",
"title": "NuGet V3 Protocol Example",
"version": "1.0.729-Unstable"
},
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.protocol.v3.example/1.0.729-unstable/nuget.protocol.v3.example.1.0.729-unstable.nupkg",
"registration": "https://api.nuget.org/v3/registration-sample/nuget.protocol.v3.example/index.json"
}
]
}
Kayıt yaprağı
Kayıt yaprağı belirli bir paket kimliği ve sürümü hakkında bilgi içerir. Belirli bir sürümle ilgili meta veriler bu belgede kullanılamayabilir. Paket meta verileri kayıt dizininden veya kayıt sayfasından (kayıt dizini kullanılarak bulunur) getirilmelidir.
Kayıt yaprağını getirme URL'si, kayıt dizini veya kayıt sayfasındaki bir kayıt yaprağı nesnesinin özelliğinden @id alınır. Sayfa belgesinde olduğu gibi. URL'nin tahmin edilebilir olması amaçlanmamıştır ve her zaman kayıt sayfası nesnesi yoluyla bulunmalıdır.
Uyarı
nuget.org'de, kayıt yaprağı belgesinin URL'si tesadüfen paket sürümünü içerir. Ancak, üst belgenin geçerli bir bağlantısı olduğu sürece sunucu uygulamaları URL'nin şeklini değiştirmekte serbest olduğundan, bu varsayım hiçbir zaman istemci tarafından yapılmamalıdır.
Kayıt yaprağı, aşağıdaki özelliklere sahip kök nesnesine sahip bir JSON belgesidir:
| Adı | Tür | Zorunlu | Notlar |
|---|---|---|---|
| @id | string | evet | Kayıt yaprağının URL'si |
| catalogEntry | Dize | hayır | Bu yaprağı oluşturan katalog girişinin URL'si |
| listelenen | boolean | hayır | Yoksa listelenmiş olarak düşünülmelidir |
| packageContent | Dize | hayır | Paket içeriğinin URL'si (.nupkg) |
| Yayınlanan | Dize | hayır | Paketin ne zaman yayımlandığına ilişkin ISO 8601 zaman damgasını içeren bir dize |
| kayıt | Dize | hayır | Kayıt dizininin URL'si |
Not
nuget.org,paket published listelenmemiş olduğunda değer 1900 yılına ayarlanır.
Örnek isteği
GET https://api.nuget.org/v3/registration-sample/nuget.versioning/4.3.0.json
Temel URL bölümünde belirtildiği gibi hizmet dizininden temel URL'yi (https://api.nuget.org/v3/registration-sample/bu örnekte) getirdiğinizden emin olun.
Örnek yanıt
{
"@id": "https://api.nuget.org/v3/registration-sample/nuget.versioning/4.3.0.json",
"catalogEntry": "https://api.nuget.org/v3/catalog0/data/2017.08.11.18.24.22/nuget.versioning.4.3.0.json",
"listed": true,
"packageContent": "https://api.nuget.org/v3-flatcontainer/nuget.versioning/4.3.0/nuget.versioning.4.3.0.nupkg",
"published": "2017-08-11T18:24:14.36+00:00",
"registration": "https://api.nuget.org/v3/registration-sample/nuget.versioning/index.json"
}