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이 아님

0

items 또는 udids가 필요함

장치가 제공되지 않음

0

항목이 너무 많음, 최대 50

배치당 최대 50개 장치

X-Lang: en

zh, en, zh-TW, vi, ar

코드 예제

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/batch" \
  -H "X-Lang: en" \
  -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은 잠겨 있어 변경할 수 없고 현재 로그인 쿠키가 포함됩니다.

POSThttps://testypro.iwai.cc/api/adddevice/batch이 사이트에 잠김

tokenstring

글로벌 사용자 API 토큰. item/defaults가 토큰을 제공하지 않을 때 사용됨

modestring

글로벌 추가 모드: instant 또는 review. 기본값은 instant; defaults.mode 또는 item.mode로 재정의 가능

defaultsobject

모든 항목에 대한 기본 파라미터. warranty/shtype/type/deviceType/beizhu/code/token/mode와 같은 단일 추가 API 파라미터를 지원

itemsarray

장치 항목 배열. 각 항목은 UDID가 필요하며 모든 기본 필드를 재정의할 수 있습니다. items/udids/udids_text 중 하나 이상 제공하십시오

udidsarray

단순화된 UDID 배열. 모든 장치에 대해 defaults/global 매개변수 사용

udids_textstring

쉼표, 세미콜론, 공백 또는 새 줄로 구분된 텍스트 UDID 목록

continue_on_errorboolean

항목이 실패한 후 계속할지 여부. 기본값은 true