GETPOST
v1.0.0stable기기 목록 조회
페이지네이션 및 상태 필터를 사용하여 인증된 사용자 장치 목록을 조회합니다.
GET | POST
/api/device/list인증:API Key
요청 매개변수
모든 매개변수는 쿼리 또는 본문을 통해 전달할 수 있습니다
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
token | string | 필수 | 사용자 API 토큰 예제: your_api_token_here |
page | number | 선택 사항 | 페이지 번호. 기본값 1 예제: 1 |
per_page | number | 선택 사항 | 페이지당 항목 수. 기본값 20, 최대 100 예제: 20 |
zt | string | 선택 사항 | 상태 필터: 전체, 정상, 숨김, 검토 중 또는 업데이트 allnormalhiddenreviewingupdate 예제: all |
shtype | string | 선택 사항 | 사후 서비스 유형 필터. 여러 값을 쉼표로 구분 예제: 1,2 |
응답
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
code | number | 필수 | 상태 코드: 1=성공, 그 외=실패 예제: 1 |
msg | string | 필수 | 응답 메시지 예제: 获取成功 |
data.devices | array | 필수 | 장치 목록 |
data.devices[].kid | string | 필수 | 기기 KID 예제: 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 | 필수 | 페이지당 실제 항목, 최대 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"
페이지당 최대 100개 항목
per_page가 100보다 크면 백엔드에서 자동으로 100으로 제한합니다
페이지당 최대 100개 항목
{}
"token":"your_api_token_here",
"page":1,
"per_page":100
오류 코드
오류 코드2 정의됨
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=hidden 은 dropped 및 update-needed 상태를 포함합니다. zt=reviewing 은 여전히 검토/예약 중인 장치를 반환합니다
콘솔에서 시도하십시오
아래 매개변수를 입력하고 테스트 요청을 보내세요. 요청은 이 사이트의 API에만 전송되며, URL은 잠겨 있어 변경할 수 없고 현재 로그인 쿠키가 포함됩니다.
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
페이지당 항목 수. 기본값 20, 최대 100
string
상태 필터: 전체, 정상, 숨김, 검토 중 또는 업데이트
string
사후 서비스 유형 필터. 여러 값을 쉼표로 구분