POST
v2.2.0stable기기 일괄 추가
유연한 기본값과 항목별 오버라이드를 사용하여 여러 UDID 일괄 등록. 각 항목은 즉시 모드 또는 예약 모드를 사용할 수 있음
POST
/api/adddevice/batch인증:API Key
제한:10/분
요청 매개변수
모든 매개변수는 쿼리 또는 본문을 통해 전달할 수 있습니다
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
token | string | 선택 사항 | 글로벌 사용자 API 토큰. item/defaults가 토큰을 제공하지 않을 때 사용됨 예제: your_api_token_here |
mode | string | 선택 사항 | 글로벌 추가 모드: instant 또는 review. 기본값은 instant; defaults.mode 또는 item.mode로 재정의 가능 instantreview 예제: instant |
defaults | object | 선택 사항 | 모든 항목에 대한 기본 파라미터. warranty/shtype/type/deviceType/beizhu/code/token/mode와 같은 단일 추가 API 파라미터를 지원 예제: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"} |
items | array | 선택 사항 | 장치 항목 배열. 각 항목은 UDID가 필요하며 모든 기본 필드를 재정의할 수 있습니다. items/udids/udids_text 중 하나 이상 제공하십시오 예제: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}] |
udids | array | 선택 사항 | 단순화된 UDID 배열. 모든 장치에 대해 defaults/global 매개변수 사용 예제: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"] |
udids_text | string | 선택 사항 | 쉼표, 세미콜론, 공백 또는 새 줄로 구분된 텍스트 UDID 목록 예제: 00008030-001234567890ABCD
00008020-00ABCDEF12345678 |
continue_on_error | boolean | 선택 사항 | 항목이 실패한 후 계속할지 여부. 기본값은 true 예제: true |
응답
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
code | number | 필수 | 상태 코드: 1=배치 요청 처리됨 예제: 1 |
data.total | number | 필수 | 요청된 총 장치 수 예제: 2 |
data.processed | number | 필수 | 실제 처리된 항목 수 예제: 2 |
data.success | number | 필수 | 성공 수 예제: 1 |
data.failed | number | 필수 | 실패 수 예제: 1 |
data.results | array | 필수 | 인덱스/UDID/모드/성공/코드/메시지/데이터/원본과 함께 항목별 결과 예제: |
응답 예제
{}
"code":1,
"msg":"배치 요청 처리됨",
"time":1769675945,
"data":
{}
"total":2,
"processed":2,
"success":1,
"failed":1,
"continueOnError":true,
"results":
[]
{}
,"index":0,
"udid":"00008030-001234567890ABCD",
"mode":"instant",
"success":true,
"code":1,
"msg":"添加成功",
"http_status":200,
"data":
{}
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
{}
"index":1,
"udid":"invalid-udid",
"mode":"review",
"success":false,
"code":0,
"msg":"UDID格式错误",
"http_status":200
오류 코드
오류 코드3 정의됨
0잘못된 JSON 본문
요청 본문이 유효한 JSON이 아님
0items 또는 udids가 필요함
장치가 제공되지 않음
0항목이 너무 많음, 최대 50
배치당 최대 50개 장치
응답 언어
X-Lang 헤더와 API 응답 언어를 사용자 지정합니다. 아래 코드 예제는 현재 사이트 언어를 자동으로 사용합니다.
공급 업체
X-Lang: ko지원되는 언어
zh, en, zh-TW, vi, ar, es, ru수락 언어는 또한 지원됩니다; X-Lang는 우선권을 가지고 갑니다. 지원되지 않은 언어는 사이트 언어 fallback를 따릅니다.
코드 예제
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/batch" \
-H "X-Lang: ko" \
-H "Content-Type: application/json" \
-d '{
"token": "your_api_token_here",
"mode": "instant",
"defaults": {
"warranty": "1",
"type": "0",
"deviceType": "iphone",
"beizhu": "batch"
},
"items": [
{
"udid": "00008030-001234567890ABCD"
},
{
"udid": "00008020-00ABCDEF12345678",
"mode": "review",
"warranty": "2",
"beizhu": "VIP device"
}
],
"udids": [
"00008030-001234567890ABCD",
"00008020-00ABCDEF12345678"
],
"udids_text": "00008030-001234567890ABCD\n00008020-00ABCDEF12345678",
"continue_on_error": true
}'참고 사항
- 이 엔드포인트는 /API/adddevice와 /API/addyydevice의 비즈니스 로직을 재사용하며 항목을 하나씩 처리합니다
- 요청 본문은 JSON이어야 합니다. 항목별 매개변수는 내부적으로 폼 매개변수로 변환됩니다
- 기본값은 공통 매개변수를 제공하며 항목 필드가 더 높은 우선순위를 가집니다
- 모드는 instant/review를 지원하며, reservation/reserve/yy/addyydevice는 review의 별칭입니다
- 요청당 최대 50개 항목이며, 요청 속도는 분당 10회로 제한됩니다
콘솔에서 시도하십시오
아래 매개변수를 입력하고 테스트 요청을 보내세요. 요청은 이 사이트의 API에만 전송되며, URL은 잠겨 있어 변경할 수 없고 현재 로그인 쿠키가 포함됩니다.
POST
https://testypro.iwai.cc/api/adddevice/batch이 사이트에 잠김string
글로벌 사용자 API 토큰. item/defaults가 토큰을 제공하지 않을 때 사용됨
string
글로벌 추가 모드: instant 또는 review. 기본값은 instant; defaults.mode 또는 item.mode로 재정의 가능
object
모든 항목에 대한 기본 파라미터. warranty/shtype/type/deviceType/beizhu/code/token/mode와 같은 단일 추가 API 파라미터를 지원
array
장치 항목 배열. 각 항목은 UDID가 필요하며 모든 기본 필드를 재정의할 수 있습니다. items/udids/udids_text 중 하나 이상 제공하십시오
array
단순화된 UDID 배열. 모든 장치에 대해 defaults/global 매개변수 사용
string
쉼표, 세미콜론, 공백 또는 새 줄로 구분된 텍스트 UDID 목록
boolean
항목이 실패한 후 계속할지 여부. 기본값은 true