Dapatkan Daftar Perangkat
Kueri daftar perangkat pengguna yang diautentikasi dengan paginasi dan filter status.
/api/device/listParameter Permintaan
Semua parameter dapat dikirim melalui Query atau Body
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
token | string | Wajib | Token API pengguna Contoh: your_api_token_here |
page | number | Opsional | Nomor halaman. Default 1 Contoh: 1 |
per_page | number | Opsional | Item per halaman. Default 20, maksimum 100 Contoh: 20 |
zt | string | Opsional | Filter status: semua, normal, tersembunyi, meninjau, atau memperbarui allnormalhiddenreviewingupdate Contoh: all |
shtype | string | Opsional | Filter jenis purna jual. Pisahkan beberapa nilai dengan koma Contoh: 1,2 |
Respon
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
code | number | Wajib | Kode status: 1=sukses, lainnya=gagal Contoh: 1 |
msg | string | Wajib | Pesan tanggapan Contoh: 获取成功 |
data.devices | array | Wajib | Daftar perangkat |
data.devices[].kid | string | Wajib | KID Perangkat Contoh: KID001 |
data.devices[].udid | string | Wajib | UDID Perangkat Contoh: 00008030-001234567890002E |
data.devices[].pname | string | Wajib | Nama perangkat Contoh: iPhone 15 Pro |
data.devices[].zt | string | Wajib | Status perangkat/sertifikat Contoh: normal |
data.devices[].ytime | number | Wajib | Cap waktu kedaluwarsa keanggotaan. 0 berarti permanen Contoh: 1772267945 |
data.devices[].enabled | boolean | Wajib | Apakah perangkat diaktifkan Contoh: true |
data.total | number | Wajib | Total perangkat yang cocok Contoh: 36 |
data.page | number | Wajib | Nomor halaman saat ini Contoh: 1 |
data.per_page | number | Wajib | Item aktual per halaman, maksimum 100 Contoh: 20 |
data.last_page | number | Wajib | Nomor halaman terakhir Contoh: 2 |
data.count_normal | number | Wajib | Jumlah perangkat normal Contoh: 30 |
data.count_hidden | number | Wajib | Jumlah perangkat yang dibuang/diblokir Contoh: 4 |
data.count_reviewing | number | Wajib | Jumlah perangkat yang ditinjau Contoh: 2 |
Query halaman pertama
Dapatkan 20 perangkat pertama dari pengguna saat ini
Hanya perangkat normal
Gunakan zt=normal untuk mengembalikan hanya perangkat normal yang tersedia
Meninjau perangkat
Gunakan zt=reviewing untuk mengembalikan perangkat yang masih dalam peninjauan/reservasi
Maksimal 100 item per halaman
Jika per_page lebih besar dari 100, backend secara otomatis membatasinya menjadi 100
Kode Kesalahan
1210Response Language
Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.
X-Lang: enzh, en, zh-TW, vi, ar, es, ruAccept-Language is also supported; X-Lang takes priority. Unsupported languages follow the site language fallback.
Contoh Kode
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
-H "X-Lang: en" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2"Catatan
- Daftar hanya mengembalikan perangkat yang dimiliki oleh pengguna token saat ini
- Maksimum per_page adalah 100. Nilai yang lebih besar secara otomatis dibatasi pada 100
- zt=hidden menyertakan status dropped dan update-needed. zt=reviewing mengembalikan perangkat yang masih dalam proses review/reservasi
Coba di Konsol
Isi parameter di bawah ini dan kirim permintaan untuk menguji. Permintaan hanya dikirim ke API situs ini; URL terkunci dan tidak dapat diubah, dan cookie login Anda saat ini disertakan.
https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Terkunci ke situs iniToken API pengguna
Nomor halaman. Default 1
Item per halaman. Default 20, maksimum 100
Filter status: semua, normal, tersembunyi, meninjau, atau memperbarui
Filter jenis purna jual. Pisahkan beberapa nilai dengan koma