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

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.

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