GETPOST
v2.2.0stable기기 추가 V2
통합 단일 장치 추가 API. 기존 API를 그대로 유지하면서 하나의 매개변수로 즉시 모드와 예약 모드 전환 가능
GET | POST
/api/adddevice/v2인증:API Key
제한:60/분
요청 매개변수
모든 매개변수는 쿼리 또는 본문을 통해 전달할 수 있습니다
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
token | string | 필수 | 사용자 API 토큰 예제: your_api_token_here |
udid | string | 필수 | 장치 UDID(25자 또는 40자여야 함) 예제: 00008030-001234567890ABCD |
mode | string | 선택 사항 | 추가 모드: 즉시 또는 검토. 기본값은 즉시 instantreview 예제: instant |
add_mode | string | 선택 사항 | 모드의 별칭. mode보다 우선 적용 instantreview 예제: review |
force | boolean | 선택 사항 | 강제 추가 플래그. true/1/yes/y/on은 강제 기간 및 기존 장치 단락 검사 건너뜀 예제: true |
warranty | string | 선택 사항 | 보증 유형: 0/1/2/3/4/6. 검토 모드는 4/6 지원 안 함 012346 예제: 1 |
shtype | string | 선택 사항 | 보증의 이전 별칭, 보증이 비어 있을 때만 사용 012346 예제: 1 |
type | string | 선택 사항 | 풀 유형: 0=공용, 1=개인. 기본값은 이전 API 논리 따름 01 예제: 0 |
deviceType | string | 선택 사항 | 장치 유형: iphone 또는 ipad. 기본 iphone iphoneipad 예제: iphone |
beizhu | string | 선택 사항 | 비고 예제: 测试设备 |
code | string | 선택 사항 | 활성화 코드(선택 사항) 예제: ABC123XYZ |
응답
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
code | number | 필수 | 상태 코드: 1=성공, 0=실패 예제: 1 |
msg | string | 필수 | 응답 메시지 예제: 添加成功 |
data.id | string | 필수 | 인증서 ID / 예약 ID 예제: AB12CD34 |
data.mobileprovision | string | 필수 | Base64 모바일 프로비전. 검토 대기 중일 때 비어 있을 수 있음 예제: Base64EncodedString... |
data.p12 | string | 필수 | Base64 P12 인증서 예제: Base64EncodedString... |
응답 예제
{}
"code":1,
"msg":"장치가 성공적으로 추가됨",
"time":1769675945,
"data":
{}
,"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
"ysucc":"Ysucc"
오류 코드
오류 코드3 정의됨
0잘못된 토큰
잘못되었거나 만료된 토큰
0잘못된 UDID 형식
UDID 길이는 25 또는 40이어야 함
0강제 추가 기간 내
새로운 추가 시도를 강제하려면 force=true를 전달
X-Lang: enzh, en, zh-TW, vi, ar코드 예제
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/v2" \
-H "X-Lang: en" \
-H "Content-Type: application/json" \
-d '{
"token": "your_api_token_here",
"udid": "00008030-001234567890ABCD",
"mode": "instant",
"add_mode": "review",
"force": true,
"warranty": "1",
"shtype": "1",
"type": "0",
"deviceType": "iphone",
"beizhu": "测试设备",
"code": "ABC123XYZ"
}'참고 사항
- 기존 /API/adddevice 및 /API/addyydevice는 계속 사용 가능하며 호환됩니다
- mode=instant는 즉시 추가 로직을 재사용하고; mode=review는 예약/검토 추가 로직을 재사용합니다
- Query, x-www-form-urlencoded 및 JSON 본문이 지원되며; V2에서는 JSON 본문 사용을 권장합니다
- force=true는 로컬 강제 기간/기존 단축 회로 검증만 건너뜁니다. Apple은 여전히 중복을 거부할 수 있습니다
- 리뷰 모드는 여전히 예약 API 제한을 따릅니다. 예: warranty=4/6는 지원되지 않음
콘솔에서 시도하십시오
아래 매개변수를 입력하고 테스트 요청을 보내세요. 요청은 이 사이트의 API에만 전송되며, URL은 잠겨 있어 변경할 수 없고 현재 로그인 쿠키가 포함됩니다.
https://testypro.iwai.cc/api/adddevice/v2?token=your_api_token_here&udid=00008030-001234567890ABCD&mode=instant&add_mode=review&force=true&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZ이 사이트에 잠김string필수
사용자 API 토큰
string필수
장치 UDID(25자 또는 40자여야 함)
string
추가 모드: 즉시 또는 검토. 기본값은 즉시
string
모드의 별칭. mode보다 우선 적용
boolean
강제 추가 플래그. true/1/yes/y/on은 강제 기간 및 기존 장치 단락 검사 건너뜀
string
보증 유형: 0/1/2/3/4/6. 검토 모드는 4/6 지원 안 함
string
보증의 이전 별칭, 보증이 비어 있을 때만 사용
string
풀 유형: 0=공용, 1=개인. 기본값은 이전 API 논리 따름
string
장치 유형: iphone 또는 ipad. 기본 iphone
string
비고
string
활성화 코드(선택 사항)