GETPOST
v1.0.0stable

Dapatkan Daftar Perangkat

Kueri daftar perangkat pengguna yang diautentikasi dengan paginasi dan filter status.

GET | POST/api/device/list
Otentikasi:API Key

Parameter Permintaan

Semua parameter dapat dikirim melalui Query atau Body

ParameterTipeWajibDeskripsi
token
stringWajib
Token API pengguna
Contoh: your_api_token_here
page
numberOpsional
Nomor halaman. Default 1
Contoh: 1
per_page
numberOpsional
Item per halaman. Default 20, maksimum 100
Contoh: 20
zt
stringOpsional
Filter status: semua, normal, tersembunyi, meninjau, atau memperbarui
allnormalhiddenreviewingupdate
Contoh: all
shtype
stringOpsional
Filter jenis purna jual. Pisahkan beberapa nilai dengan koma
Contoh: 1,2

Respon

ParameterTipeWajibDeskripsi
code
numberWajib
Kode status: 1=sukses, lainnya=gagal
Contoh: 1
msg
stringWajib
Pesan tanggapan
Contoh: 获取成功
data.devices
arrayWajib
Daftar perangkat
data.devices[].kid
stringWajib
KID Perangkat
Contoh: KID001
data.devices[].udid
stringWajib
UDID Perangkat
Contoh: 00008030-001234567890002E
data.devices[].pname
stringWajib
Nama perangkat
Contoh: iPhone 15 Pro
data.devices[].zt
stringWajib
Status perangkat/sertifikat
Contoh: normal
data.devices[].ytime
numberWajib
Cap waktu kedaluwarsa keanggotaan. 0 berarti permanen
Contoh: 1772267945
data.devices[].enabled
booleanWajib
Apakah perangkat diaktifkan
Contoh: true
data.total
numberWajib
Total perangkat yang cocok
Contoh: 36
data.page
numberWajib
Nomor halaman saat ini
Contoh: 1
data.per_page
numberWajib
Item aktual per halaman, maksimum 100
Contoh: 20
data.last_page
numberWajib
Nomor halaman terakhir
Contoh: 2
data.count_normal
numberWajib
Jumlah perangkat normal
Contoh: 30
data.count_hidden
numberWajib
Jumlah perangkat yang dibuang/diblokir
Contoh: 4
data.count_reviewing
numberWajib
Jumlah perangkat yang ditinjau
Contoh: 2
Contoh Respon
{
"code":1,
"msg":"Sukses",
"time":1769675945,
"data":
{
"devices":
[
{
"kid":"KID001",
"udid":"00008030-001234567890002E",
"pname":"iPhone 15 Pro",
"type":"iphone",
"shtype":1,
"zt":"normal",
"ytime":1772267945,
"model":"iPhone16,1",
"beizhu":"主力设备",
"enabled":true
}
]
,
"total":36,
"page":1,
"per_page":20,
"last_page":2,
"count_normal":30,
"count_hidden":4,
"count_reviewing":2
}
,
"ip":"192.168.1.100",
"ysucc":"Ysucc"
}

Query halaman pertama

Dapatkan 20 perangkat pertama dari pengguna saat ini

Query halaman pertama
{
"token":"your_api_token_here",
"page":1,
"per_page":20
}

Hanya perangkat normal

Gunakan zt=normal untuk mengembalikan hanya perangkat normal yang tersedia

Hanya perangkat normal
{
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
}

Meninjau perangkat

Gunakan zt=reviewing untuk mengembalikan perangkat yang masih dalam peninjauan/reservasi

Meninjau perangkat
{
"token":"your_api_token_here",
"zt":"reviewing"
}

Maksimal 100 item per halaman

Jika per_page lebih besar dari 100, backend secara otomatis membatasinya menjadi 100

Maksimal 100 item per halaman
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

Kode Kesalahan

Kode Kesalahan2 didefinisikan
12
Token diperlukan
Parameter token hilang
10
Token tidak valid
Token tidak ada atau status pengguna tidak diizinkan

X-Lang: en
zh, en, zh-TW, vi, ar

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 ini
stringWajib

Token API pengguna

number

Nomor halaman. Default 1

number

Item per halaman. Default 20, maksimum 100

string

Filter status: semua, normal, tersembunyi, meninjau, atau memperbarui

string

Filter jenis purna jual. Pisahkan beberapa nilai dengan koma