GETPOST
v1.0.0stable

Cihaz Listesini Sorgula

Yetkilendirilmiş kullanıcı cihaz listesini sayfalama ve durum filtreleriyle sorgulayın.

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

İstek Parametreleri

Tüm parametreler Sorgu veya Gövde üzerinden iletilebilir

ParametreTürGerekliAçıklama
token
stringGerekli
Kullanıcı API token'ı
Örnek: your_api_token_here
page
numberİsteğe bağlı
Sayfa numarası. Varsayılan 1
Örnek: 1
per_page
numberİsteğe bağlı
Sayfa başına öğe sayısı. Varsayılan 20, maksimum 100
Örnek: 20
zt
stringİsteğe bağlı
Durum filtresi: tümü, normal, gizli, inceleniyor veya güncelleme
allnormalhiddenreviewingupdate
Örnek: all
shtype
stringİsteğe bağlı
Satış sonrası tür filtresi. Birden fazla değeri virgülle ayırın
Örnek: 1,2

Yanıt

ParametreTürGerekliAçıklama
code
numberGerekli
Durum kodu: 1=başarı, diğerleri=başarısızlık
Örnek: 1
msg
stringGerekli
Yanıt mesajı
Örnek: 获取成功
data.devices
arrayGerekli
Cihaz listesi
data.devices[].kid
stringGerekli
Cihaz KID
Örnek: KID001
data.devices[].udid
stringGerekli
Cihaz UDID
Örnek: 00008030-001234567890002E
data.devices[].pname
stringGerekli
Cihaz adı
Örnek: iPhone 15 Pro
data.devices[].zt
stringGerekli
Cihaz/sertifika durumu
Örnek: normal
data.devices[].ytime
numberGerekli
Üyelik bitiş zaman damgası. 0 kalıcı anlamına gelir
Örnek: 1772267945
data.devices[].enabled
booleanGerekli
Cihazın etkin olup olmadığı
Örnek: true
data.total
numberGerekli
Toplam eşleşen cihazlar
Örnek: 36
data.page
numberGerekli
Mevcut sayfa numarası
Örnek: 1
data.per_page
numberGerekli
Sayfa başına gerçek öğe sayısı, maksimum 100
Örnek: 20
data.last_page
numberGerekli
Son sayfa numarası
Örnek: 2
data.count_normal
numberGerekli
Normal cihaz sayısı
Örnek: 30
data.count_hidden
numberGerekli
Düşen/engellenen cihaz sayısı
Örnek: 4
data.count_reviewing
numberGerekli
İncelenen cihaz sayısı
Örnek: 2
Yanıt Örneği
{
"code":1,
"msg":"Başarılı",
"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"
}

İlk sayfayı sorgula

Mevcut kullanıcının ilk 20 cihazını al

İlk sayfayı sorgula
{
"token":"your_api_token_here",
"page":1,
"per_page":20
}

Sadece normal cihazlar

Yalnızca mevcut normal cihazları döndürmek için zt=normal kullanın

Sadece normal cihazlar
{
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
}

Cihazları inceleme

Hâlâ inceleme/rezerve aşamasında olan cihazları döndürmek için zt=reviewing kullanın

Cihazları inceleme
{
"token":"your_api_token_here",
"zt":"reviewing"
}

Sayfa başına maksimum 100 öğe

per_page 100'den büyükse, arka uç otomatik olarak 100 ile sınırlar

Sayfa başına maksimum 100 öğe
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

Hata Kodları

Hata Kodları2 tanımlandı
12
Token gereklidir
Eksik token parametresi
10
Geçersiz token
Token mevcut değil veya kullanıcı durumu izin verilmiyor

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

Kod Örnekleri

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"

Notlar

  • Liste yalnızca mevcut token kullanıcısına ait cihazları döndürür
  • Sayfa başına maksimum değer 100'dür. Daha büyük değerler otomatik olarak 100 ile sınırlandırılır
  • zt=hidden düşürülmüş ve güncelleme gerektiren durumları içerir. zt=reviewing, hâlâ incelemede/rezervasyonda olan cihazları döndürür

Konsolda deneyin

Aşağıdaki parametreleri doldurun ve testi yapmak için bir istek gönderin. İstekler yalnızca bu sitenin API'sine gider; URL kilitli ve değiştirilemez, mevcut giriş çereziniz dahil edilir.

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Bu siteye kilitli
stringGerekli

Kullanıcı API token'ı

number

Sayfa numarası. Varsayılan 1

number

Sayfa başına öğe sayısı. Varsayılan 20, maksimum 100

string

Durum filtresi: tümü, normal, gizli, inceleniyor veya güncelleme

string

Satış sonrası tür filtresi. Birden fazla değeri virgülle ayırın