GETPOST
v1.0.0stableデバイス一覧取得
ページネーションとステータスフィルタを使用して、認証されたユーザーデバイスリストを照会します。
GET | POST
/api/device/listauth:API Key
リクエストパラメータ
すべてのパラメータは、クエリまたは本文を介して渡すことができます
| パラメーター | タイプ | 必須 | 内容 |
|---|---|---|---|
token | string | 必須 | API トークン 例: your_api_token_here |
page | number | オプション | ページ番号。デフォルト1 例: 1 |
per_page | number | オプション | 1ページあたりのアイテム数。デフォルト20、最大100 例: 20 |
zt | string | オプション | ステータスフィルター： ALL、NORMAL、HIDDEN、REVIEWING、UPDATE allnormalhiddenreviewingupdate 例: all |
shtype | string | オプション | アフターセールスタイプのフィルター。複数の値をカンマで区切ります 例: 1,2 |
回答
| パラメーター | タイプ | 必須 | 内容 |
|---|---|---|---|
code | number | 必須 | ステータスコード： 1 =成功、その他=失敗 例: 1 |
msg | string | 必須 | 応答メッセージ 例: 获取成功 |
data.devices | array | 必須 | 機器一覧 |
data.devices[].kid | string | 必須 | デバイスキッド 例: KID001 |
data.devices[].udid | string | 必須 | デバイスUDID 例: 00008030-001234567890002E |
data.devices[].pname | string | 必須 | デバイス名 例: iPhone 15 Pro |
data.devices[].zt | string | 必須 | デバイス/証明書のステータス 例: normal |
data.devices[].ytime | number | 必須 | メンバーシップの有効期限のタイムスタンプ。0は永続的を意味します 例: 1772267945 |
data.devices[].enabled | boolean | 必須 | デバイスが有効かどうか 例: true |
data.total | number | 必須 | マッチしたデバイスの合計 例: 36 |
data.page | number | 必須 | 現在のページ番号 例: 1 |
data.per_page | number | 必須 | 1ページあたりの実際の項目数、最大100 例: 20 |
data.last_page | number | 必須 | ページ数 例: 2 |
data.count_normal | number | 必須 | 通常のデバイス数 例: 30 |
data.count_hidden | number | 必須 | 削除/禁止されたデバイス数 例: 4 |
data.count_reviewing | number | 必須 | デバイス数の確認 例: 2 |
応答例
{}
"code":1,
"msg":"成功",
"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"
最初のページにクエリ
現在のユーザーの最初の20台のデバイスを取得する
最初のページにクエリ
{}
"token":"your_api_token_here",
"page":1,
"per_page":20
通常のデバイスのみ
使用可能な通常のデバイスのみを返すには、zt = normalを使用します
通常のデバイスのみ
{}
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
デバイスを確認しています
Zt = reviewingを使用して、まだレビュー中/予約中のデバイスを返却する
デバイスを確認しています
{}
"token":"your_api_token_here",
"zt":"reviewing"
1ページあたり最大100項目
Per_pageが100を超える場合、バックエンドは自動的に100に上限を設定します
1ページあたり最大100項目
{}
"token":"your_api_token_here",
"page":1,
"per_page":100
エラーコード
エラーコード2 defined
12トークンは必須です。
トークンパラメーターがありません
10無効なトークン
トークンが存在しないか、ユーザーステータスが許可されていません
X-Lang: enzh, en, zh-TW, vi, arコード例
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"注
- リストは、現在のトークンユーザーが所有するデバイスのみを返します
- PER_PAGEの最大数は100です。大きな値は自動的に100に制限されます
- zt =隠された状態には、ドロップされた状態と更新が必要な状態が含まれます。zt =レビュー中/予約中の返品デバイスのレビュー
コンソールでお試しください
以下のパラメータを入力し、テストのリクエストを送信します。リクエストはこのサイトのAPIにのみ行きます。URLはロックされており、変更することはできません。現在のログインCookieが含まれています。
https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2このサイトにロックされていますstring必須
API トークン
number
ページ番号。デフォルト1
number
1ページあたりのアイテム数。デフォルト20、最大100
string
ステータスフィルター： ALL、NORMAL、HIDDEN、REVIEWING、UPDATE
string
アフターセールスタイプのフィルター。複数の値をカンマで区切ります