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

Response Language

Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.

Recommended Header
X-Lang: en
Supported Languages
zh, en, zh-TW, vi, ar, es, ru

Accept-Language is also supported; X-Lang takes priority. Unsupported languages follow the site language fallback.

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