GETPOST
v1.0.0stable

Dapatkan Senarai Peranti

Pertanyakan senarai peranti pengguna yang diautentikasi dengan penjujukan muka surat dan penapis status.

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

Parameter Permintaan

Semua parameter boleh dihantar melalui Kuiri atau Badan

ParameterJenisDiperlukanPenerangan
token
stringDiperlukan
Token API pengguna
Contoh: your_api_token_here
page
numberPilihan
Nombor muka surat. Lalai 1
Contoh: 1
per_page
numberPilihan
Item setiap muka surat. Lalai 20, maksimum 100
Contoh: 20
zt
stringPilihan
Penapis status: semua, normal, tersembunyi, menyemak, atau kemas kini
allnormalhiddenreviewingupdate
Contoh: all
shtype
stringPilihan
Penapis jenis selepas jualan. Pisahkan beberapa nilai dengan koma
Contoh: 1,2

Respons

ParameterJenisDiperlukanPenerangan
code
numberDiperlukan
Kod status: 1=berjaya, lain-lain=gagal
Contoh: 1
msg
stringDiperlukan
Mesej tindak balas
Contoh: 获取成功
data.devices
arrayDiperlukan
Senarai peranti
data.devices[].kid
stringDiperlukan
KID Peranti
Contoh: KID001
data.devices[].udid
stringDiperlukan
UDID Peranti
Contoh: 00008030-001234567890002E
data.devices[].pname
stringDiperlukan
Nama Peranti
Contoh: iPhone 15 Pro
data.devices[].zt
stringDiperlukan
Status Peranti/sijil
Contoh: normal
data.devices[].ytime
numberDiperlukan
Cap masa luput keahlian. 0 bermaksud kekal
Contoh: 1772267945
data.devices[].enabled
booleanDiperlukan
Sama ada peranti diaktifkan
Contoh: true
data.total
numberDiperlukan
Jumlah peranti yang sepadan
Contoh: 36
data.page
numberDiperlukan
Nombor halaman semasa
Contoh: 1
data.per_page
numberDiperlukan
Item sebenar setiap halaman, maksimum 100
Contoh: 20
data.last_page
numberDiperlukan
Nombor halaman terakhir
Contoh: 2
data.count_normal
numberDiperlukan
Jumlah peranti normal
Contoh: 30
data.count_hidden
numberDiperlukan
Jumlah peranti yang ditutup/diharamkan
Contoh: 4
data.count_reviewing
numberDiperlukan
Jumlah peranti yang sedang disemak
Contoh: 2
Contoh Respons
{
"code":1,
"msg":"Berjaya",
"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"
}

Pertanyaan halaman pertama

Dapatkan 20 peranti pertama untuk pengguna semasa

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

Hanya peranti biasa

Gunakan zt=normal untuk memaparkan hanya peranti biasa yang tersedia

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

Menyemak peranti

Gunakan zt=reviewing untuk memaparkan peranti yang masih dalam semakan/tempahan

Menyemak peranti
{
"token":"your_api_token_here",
"zt":"reviewing"
}

Maksimum 100 item setiap halaman

Jika per_page melebihi 100, backend secara automatik akan mengehadkannya kepada 100

Maksimum 100 item setiap halaman
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

Kod Ralat

Kod Ralat2 ditakrifkan
12
Token diperlukan
Parameter token hilang
10
Token tidak sah
Token tidak wujud atau status pengguna tidak dibenarkan

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

Contoh Kod

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"

Nota

  • Senarai hanya memaparkan peranti yang dimiliki oleh pengguna token semasa
  • Maksimum per_page ialah 100. Nilai yang lebih besar secara automatik dihadkan kepada 100
  • zt=hidden termasuk keadaan dropped dan update-needed. zt=reviewing mengembalikan peranti yang masih dalam semakan/tempahan

Cuba di Konsol

Isikan parameter di bawah dan hantar permintaan untuk menguji. Permintaan hanya dihantar ke API laman ini; URL dikunci dan tidak boleh diubah, dan kuki log masuk semasa anda disertakan.

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Dikunci ke laman ini
stringDiperlukan

Token API pengguna

number

Nombor muka surat. Lalai 1

number

Item setiap muka surat. Lalai 20, maksimum 100

string

Penapis status: semua, normal, tersembunyi, menyemak, atau kemas kini

string

Penapis jenis selepas jualan. Pisahkan beberapa nilai dengan koma