Topik ini menjelaskan cara menggunakan operasi API untuk menanyakan pencarian teratas dan petunjuk.
Kueri Daftar Pencarian Teratas
Menanyakan daftar pencarian teratas. Secara default, hasil yang dikembalikan adalah daftar pencarian teratas yang direkomendasikan oleh model.
Metode permintaan HTTP yang didukung
GET
URL
/v3/openapi/apps/{app_name}/actions/hot?hit={hit}&sort_type={sort_type}&user_id={user_id}&model_name={model_name}Contoh URL menghilangkan informasi seperti header permintaan dan metode pengkodean.
Contoh URL juga menghilangkan titik akhir yang digunakan untuk terhubung ke aplikasi OpenSearch.
Parameter permintaan
Parameter | Diperlukan | Tipe | Nilai default | Deskripsi | Catatan |
app_name | Ya | string | Nama aplikasi OpenSearch. | ||
hit | Tidak | int | 10 | Jumlah pencarian teratas yang akan ditanyakan. | Nilai valid: (0,30]. |
sort_type | Tidak | string | default | Metode pengurutan dari pencarian teratas yang diminta. Jika parameter ini diatur ke default, pencarian teratas tidak diurutkan. Jika parameter ini diatur ke pv, pencarian teratas diurutkan berdasarkan jumlah tampilan halaman (PV) dalam urutan menurun. Jika parameter ini diatur ke uv, pencarian teratas diurutkan berdasarkan jumlah pengunjung unik (UV) yang mengklik pencarian teratas dalam urutan menurun. Opsi uv akan segera didukung. | |
model_name | Tidak | string | Nama model berdasarkan hasil yang dikembalikan. |
Parameter respons
Parameter | Diperlukan | Nilai default | Tipe | Deskripsi |
request_id | Ya | string | ID permintaan. | |
result | Ya | array | Pencarian teratas yang diminta. |
Contoh permintaan
http://$host/v3/openapi/apps/{app_name}/actions/hot?hit={hit}&sort_type={sort_type}&model_name={model_name}Contoh respons
Contoh Respons Sukses
{ "request_id": "150116615820104116121674", "searchtime": 0.002654, "result": [ { "hot": "Gaun satu potong", // Pencarian teratas. "pv": 100000, // Jumlah permintaan yang dikumpulkan selama periode pelatihan. Secara default, sistem mengumpulkan jumlah permintaan dalam 14 hari untuk model reguler. "tags":0 // Tag yang dikembalikan oleh model pencarian teratas real-time. Nilai 0 menunjukkan baru. Nilai 1 menunjukkan panas. Nilai 2 menunjukkan viral. }, { "hot": "Gaun satu potong untuk musim semi", "pv": 50000 }, { "hot": "Gaun satu potong untuk pecinta seni", "pv": 10000 } ] }Contoh Respons Kesalahan
Untuk informasi lebih lanjut, lihat Kode Kesalahan.
Kueri Daftar Petunjuk
Menanyakan daftar petunjuk. Secara default, hasil yang dikembalikan adalah daftar petunjuk yang direkomendasikan oleh model.
Metode permintaan HTTP yang didukung
GET
URL
/v3/openapi/apps/{app_name}/actions/hint?hit={hit}&sort_type={sort_type}&user_id={user_id}&model_name={model_name}Contoh URL menghilangkan informasi seperti header permintaan dan metode pengkodean.
Contoh URL juga menghilangkan titik akhir yang digunakan untuk terhubung ke aplikasi OpenSearch.
Parameter permintaan
Parameter | Diperlukan | Tipe | Nilai default | Deskripsi | Catatan |
app_name | Ya | string | Nama aplikasi OpenSearch. | ||
hit | Tidak | int | 3 | Jumlah petunjuk yang akan ditanyakan. | Nilai valid untuk petunjuk umum: (0,10]. Nilai valid untuk petunjuk personalisasi: (0,30]. |
sort_type | Tidak | string | default | Metode pengurutan dari petunjuk yang diminta. Jika parameter ini diatur ke default, petunjuk tidak diurutkan. Jika parameter ini diatur ke pv, petunjuk diurutkan berdasarkan jumlah PV dalam urutan menurun. | |
user_id | Tidak | string | ID pengguna yang mengirim permintaan. Parameter ini diperlukan untuk menanyakan petunjuk personalisasi. | Jika Anda tidak menentukan parameter ini atau pengguna yang ditentukan tidak ada, petunjuk umum yang diminta. | |
model_name | Tidak | string | Nama model berdasarkan hasil yang dikembalikan. | Jika Anda tidak menentukan parameter ini, model default digunakan. |
Parameter respons
Parameter | Tipe | Deskripsi |
data | object | Hasil kueri. |
Deskripsi parameter
Parameter | Diperlukan | Nilai default | Tipe | Deskripsi |
list | Ya | array | Daftar petunjuk yang diminta. |
Contoh permintaan
http://$host/v3/openapi/apps/{app_name}/actions/hint?hit={hit}&sort_type={sort_type}&user_id={user_id}&model_name={model_name}Contoh respons
Contoh Respons Sukses
{ "request_id": "150116615820104116121674", "searchtime": 0.002654, "result": [ { "hint": "Gaun satu potong", "pv": 100000 }, { "hint": "Gaun satu potong untuk musim semi", "pv": 50000 }, { "hint": "Gaun satu potong untuk pecinta seni", "pv": 10000 } ] }Contoh Respons Kesalahan
Untuk informasi lebih lanjut, lihat Kode Kesalahan.