Cari

Artikel
05/22/2024

Dimungkinkan untuk mencari paket yang tersedia di sumber paket menggunakan API V3. Sumber daya yang digunakan untuk pencarian adalah sumber daya yang SearchQueryService ditemukan dalam indeks layanan.

Penerapan versi

Nilai berikut @type digunakan:

@type nilai	Catatan
SearchQueryService	Rilis awal
SearchQueryService/3.0.0-beta	Alias dari `SearchQueryService`
SearchQueryService/3.0.0-rc	Alias dari `SearchQueryService`
SearchQueryService/3.5.0	Menyertakan dukungan untuk `packageType` parameter kueri

SearchQueryService/3.5.0

Versi ini memperkenalkan dukungan untuk packageType parameter kueri dan packageTypes properti respons, memungkinkan pemfilteran menurut jenis paket yang ditentukan penulis. Ini sepenuhnya kompatibel dengan kueri ke SearchQueryService.

URL Dasar

URL dasar untuk API berikut adalah nilai properti yang @id terkait dengan salah satu nilai sumber daya @type yang disebutkan di atas. Dalam dokumen berikut, URL {@id} dasar tempat penampung akan digunakan. URL dasar dapat berubah berdasarkan implementasi atau perubahan infrastruktur dalam sumber paket sehingga harus diambil secara dinamis dari indeks layanan oleh perangkat lunak klien.

Metode HTTP

Semua URL yang ditemukan di sumber daya pendaftaran mendukung metode GET HTTP dan HEAD.

Mencari paket

API pencarian memungkinkan klien untuk mengkueri halaman paket yang cocok dengan kueri pencarian tertentu. Interpretasi kueri pencarian (misalnya tokenisasi istilah pencarian) ditentukan oleh implementasi server tetapi harapan umumnya adalah bahwa kueri pencarian digunakan untuk mencocokkan ID paket, judul, deskripsi, dan tag. Bidang metadata paket lainnya juga dapat dipertimbangkan.

Paket yang tidak terdata tidak boleh muncul di hasil pencarian.

GET {@id}?q={QUERY}&skip={SKIP}&take={TAKE}&prerelease={PRERELEASE}&semVerLevel={SEMVERLEVEL}&packageType={PACKAGETYPE}

Parameter permintaan

Nama	Dalam	Jenis	Wajib	Catatan
q	URL	string	no	Istilah pencarian yang digunakan untuk memfilter paket
skip	URL	Integer	no	Jumlah hasil yang akan dilewati, untuk penomoran halaman
take	URL	Integer	no	Jumlah hasil yang akan dikembalikan, untuk penomoran halaman
Prerelease	URL	Boolean	no	`true` atau `false` menentukan apakah akan menyertakan paket pra-rilis
semVerLevel	URL	string	no	String versi SemVer 1.0.0
packageType	URL	string	no	Jenis paket yang digunakan untuk memfilter paket (ditambahkan dalam `SearchQueryService/3.5.0`)

Kueri q pencarian diurai dengan cara yang ditentukan oleh implementasi server. nuget.org mendukung pemfilteran dasar pada berbagai bidang. Jika tidak q ada yang disediakan, semua paket harus dikembalikan, dalam batas yang diberlakukan oleh lewati dan ambil. Ini memungkinkan tab "Telusuri" di pengalaman NuGet Visual Studio.

Parameter skip default ke 0.

Parameter take harus berupa bilangan bulat yang lebih besar dari nol. Implementasi server dapat memberlakukan nilai maksimum.

Catatan

nuget.org membatasi skip parameter hingga 3.000 dan take parameter hingga 1.000.

Jika prerelease tidak disediakan, paket pra-rilis dikecualikan.

Parameter semVerLevel kueri digunakan untuk ikut serta dalam paket SemVer 2.0.0. Jika parameter kueri ini dikecualikan, hanya paket dengan versi yang kompatibel Dengan SemVer 1.0.0 yang akan dikembalikan (dengan peringatan penerapan versi NuGet standar, seperti string versi dengan 4 bagian bilangan bulat). Jika semVerLevel=2.0.0 disediakan, paket kompatibel SemVer 1.0.0 dan SemVer 2.0.0 akan dikembalikan. Lihat dukungan SemVer 2.0.0 untuk nuget.org untuk informasi selengkapnya.

Parameter packageType digunakan untuk memfilter hasil pencarian lebih lanjut hanya ke paket yang memiliki setidaknya satu jenis paket yang cocok dengan nama jenis paket. Jika jenis paket yang disediakan bukan jenis paket yang valid seperti yang didefinisikan oleh dokumen Jenis Paket, hasil kosong akan dikembalikan. Jika jenis paket yang disediakan kosong, tidak ada filter yang akan diterapkan. Dengan kata lain, meneruskan tidak ada nilai ke parameter packageType akan berperilaku seolah-olah parameter tidak diteruskan.

Respons

Responsnya adalah dokumen JSON yang berisi hingga take hasil pencarian. Hasil pencarian dikelompokkan menurut ID paket.

Objek JSON akar memiliki properti berikut:

Nama	Tipe	Wajib	Catatan
totalHits	Integer	yes	Jumlah total kecocokan, pengalihan `skip` , dan `take`
data	array objek	yes	Hasil pencarian cocok dengan permintaan

Hasil pencarian

Setiap item dalam data array adalah objek JSON yang terdiri dari sekelompok versi paket yang berbagi ID paket yang sama. Objek memiliki properti berikut:

Nama	Tipe	Wajib	Catatan
id	string	yes	ID paket yang cocok
versi	string	yes	String versi SemVer 2.0.0 lengkap dari paket (dapat berisi metadata build)
description	string	no
versi	array objek	yes	Semua versi paket yang cocok dengan `prerelease` parameter
penulis	string atau array string	no
iconUrl	string	no
licenseUrl	string	no
Pemilik	string atau array string	no	String mewakili nama pengguna pemilik tunggal
projectUrl	string	no
registrasi	string	no	URL absolut ke indeks pendaftaran terkait
ringkasan	string	no
tag	string atau array string	no
title	string	no
totalUnduh	Integer	no	Nilai ini dapat disimpulkan oleh jumlah unduhan dalam `versions` array
Diverifikasi	Boolean	no	Boolean JSON yang menunjukkan apakah paket diverifikasi
packageTypes	array objek	yes	Jenis paket yang ditentukan oleh pembuat paket (ditambahkan dalam `SearchQueryService/3.5.0`)

Pada nuget.org, paket terverifikasi adalah paket yang memiliki ID paket yang cocok dengan awalan ID yang dipesan dan dimiliki oleh salah satu pemilik prefiks yang dipesan. Untuk informasi selengkapnya, lihat dokumentasi tentang reservasi awalan ID.

Metadata yang terkandung dalam objek hasil pencarian diambil dari versi paket terbaru. Setiap item dalam versions array adalah objek JSON dengan properti berikut:

Nama	Tipe	Wajib	Catatan
@id	string	yes	URL absolut ke daun pendaftaran terkait
versi	string	yes	String versi SemVer 2.0.0 lengkap dari paket (dapat berisi metadata build)
Mingguan	Integer	yes	Jumlah unduhan untuk versi paket tertentu ini

Array packageTypes akan selalu terdiri dari setidaknya satu (1) item. Jenis paket untuk ID paket tertentu dianggap sebagai jenis paket yang ditentukan oleh versi terbaru paket sehubungan dengan parameter pencarian lainnya. Setiap item dalam packageTypes array adalah objek JSON dengan properti berikut:

Nama	Tipe	Wajib	Catatan
nama	string	yes	Nama jenis paket.

Permintaan sampel

GET https://search-sample.nuget.org/query?q=NuGet.Versioning&prerelease=false&semVerLevel=2.0.0

Pastikan untuk mengambil URL dasar (https://search-sample.nuget.org/query dalam sampel ini) dari indeks layanan seperti yang disebutkan di bagian URL dasar.

Respon sampel

{
  "totalHits": 2,
  "data": [
    {
      "registration": "https://api.nuget.org/v3/registration-sample/nuget.versioning/index.json",
      "id": "NuGet.Versioning",
      "version": "4.4.0",
      "description": "NuGet's implementation of Semantic Versioning.",
      "summary": "",
      "title": "NuGet.Versioning",
      "licenseUrl": "https://raw.githubusercontent.com/NuGet/NuGet.Client/dev/LICENSE.txt",
      "tags": [ "semver", "semantic", "versioning" ],
      "authors": [ "NuGet" ],
      "totalDownloads": 141896,
      "verified": true,
      "packageTypes": [
        {
          "name": "Dependency"
        }
      ],
      "versions": [
        {
          "version": "3.3.0",
          "downloads": 50343,
          "@id": "https://api.nuget.org/v3/registration-sample/nuget.versioning/3.3.0.json"
        },
        {
          "version": "3.4.3",
          "downloads": 27932,
          "@id": "https://api.nuget.org/v3/registration-sample/nuget.versioning/3.4.3.json"
        },
        {
          "version": "4.0.0",
          "downloads": 63004,
          "@id": "https://api.nuget.org/v3/registration-sample/nuget.versioning/4.0.0.json"
        },
        {
          "version": "4.4.0",
          "downloads": 617,
          "@id": "https://api.nuget.org/v3/registration-sample/nuget.versioning/4.4.0.json"
        }
      ]
    },
    {
      "@id": "https://api.nuget.org/v3/registration-sample/nerdbank.gitversioning/index.json",
      "@type": "Package",
      "registration": "https://api.nuget.org/v3/registration-sample/nerdbank.gitversioning/index.json",
      "id": "Nerdbank.GitVersioning",
      "version": "2.0.41",
      "description": "Stamps your assemblies with semver 2.0 compliant git commit specific version information and provides NuGet versioning information as well.",
      "summary": "Stamps your assemblies with semver 2.0 compliant git commit specific version information and provides NuGet versioning information as well.",
      "title": "Nerdbank.GitVersioning",
      "licenseUrl": "https://raw.githubusercontent.com/AArnott/Nerdbank.GitVersioning/ed547462f7/LICENSE.txt",
      "projectUrl": "http://github.com/aarnott/Nerdbank.GitVersioning",
      "tags": [ "git", "commit", "versioning", "version", "assemblyinfo" ],
      "authors": [ "Andrew Arnott" ],
      "totalDownloads": 11906,
      "verified": false,
      "versions": [
        {
          "version": "1.6.35",
          "downloads": 10229,
          "@id": "https://api.nuget.org/v3/registration-sample/nerdbank.gitversioning/1.6.35.json"
        },
        {
          "version": "2.0.41",
          "downloads": 1677,
          "@id": "https://api.nuget.org/v3/registration-sample/nerdbank.gitversioning/2.0.41.json"
        }
      ]
    }
  ]
}

Bagikan melalui