Bagikan melalui


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 ReportAbuseUriTemplateditemukan 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