Laporkan templat URL penyalahgunaan
Klien dapat membuat URL yang dapat digunakan oleh pengguna untuk melaporkan penyalahgunaan tentang paket tertentu. Ini berguna ketika sumber paket ingin mengaktifkan semua pengalaman klien (bahkan pihak ke-3) untuk mendelegasikan laporan penyalahgunaan ke sumber paket.
Sumber daya yang digunakan untuk membangun URL ini adalah sumber daya yang ReportAbuseUriTemplate
ditemukan dalam indeks layanan.
Penerapan versi
Nilai berikut @type
digunakan:
@type nilai | Catatan |
---|---|
ReportAbuseUriTemplate/3.0.0-beta | Rilis awal |
ReportAbuseUriTemplate/3.0.0-rc | Alias dari ReportAbuseUriTemplate/3.0.0-beta |
Templat URL
URL untuk API berikut adalah nilai properti yang @id
terkait dengan salah satu nilai sumber daya @type
yang disebutkan di atas.
Metode HTTP
Meskipun klien tidak dimaksudkan untuk membuat permintaan ke URL penyalahgunaan laporan atas nama pengguna, halaman web harus mendukung GET
metode untuk memungkinkan URL yang diklik dibuka dengan mudah di browser web.
Membuat URL
Mengingat ID dan versi paket yang diketahui, implementasi klien dapat membuat URL yang digunakan untuk mengakses antarmuka web. Implementasi klien harus menampilkan URL yang dibangun ini (atau tautan yang dapat diklik) kepada pengguna yang memungkinkan mereka membuka browser web ke URL dan membuat laporan penyalahgunaan yang diperlukan. Implementasi formulir laporan penyalahgunaan ditentukan oleh implementasi server.
Nilai @id
adalah string URL yang berisi salah satu token tempat penampung berikut:
Tempat penampung URL
Nama | Tipe | Diperlukan | Catatan |
---|---|---|---|
{id} |
string | no | ID paket untuk melaporkan penyalahgunaan untuk |
{version} |
string | no | Versi paket untuk melaporkan penyalahgunaan untuk |
Nilai {id}
dan {version}
yang ditafsirkan oleh implementasi server harus tidak peka huruf besar/kecil dan tidak sensitif terhadap apakah versi dinormalisasi.
Misalnya, templat penyalahgunaan laporan nuget.org terlihat seperti ini:
https://www.nuget.org/packages/{id}/{version}/ReportAbuse
Jika implementasi klien perlu menampilkan tautan ke formulir penyalahgunaan laporan untuk NuGet.Versioning 4.3.0, itu akan menghasilkan URL berikut dan memberikannya kepada pengguna:
https://www.nuget.org/packages/NuGet.Versioning/4.3.0/ReportAbuse