返回首頁API 文件
語言: 繁體中文
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
返回文檔列表
GETPOST
v2.1.0stable

秒出添加設備

提交設備 UDID，立即返回 mobileprovision 和 P12

GET | POST/api/adddevice
驗證:API Key
速率限制:60/分鐘

請求參數

所有請求參數需透過 Query 或 Body 傳遞

參數名類型必填說明
token
string必填
用戶 API Token
範例: your_api_token_here
udid
string必填
設備 UDID（長度必須為 25 或 40）
範例: 00008030-001234567890ABCD
warranty
string選填
售後類型：0=躺平版，1=標準版，2=加強版，3=穩定版，4=擺爛版，6=高擺爛版。建議顯式傳入；缺省或非法值在價格計算中按標準版處理
012346
範例: 1
shtype
string選填
warranty 的別名，僅在 warranty 為空時生效
012346
範例: 1
type
string選填
池類型：0=公共池，1=獨立池。預設 0
01
範例: 0
deviceType
string選填
設備類型：iphone 或 ipad。預設 iphone
iphoneipad
範例: iphone
beizhu
string選填
備註（最多 40 個字元，超出截斷）
範例: 测试设备
code
string選填
卡密（可選）
範例: ABC123XYZ

回應參數

參數名類型必填說明
code
number必填
狀態碼：1=成功，0=失敗
範例: 1
msg
string必填
返回訊息
範例: 添加成功
time
number必填
伺服器時間戳（Unix 秒）
範例: 1769675945
data
object必填
業務數據
data.id
string必填
證書 ID（8 位）
範例: AB12CD34
data.pool
number必填
池標識：0=公共池，1=獨立池
範例: 0
data.addtime
number必填
添加時間（Unix）
範例: 1706500000
data.mobileprovision
string必填
Base64 mobileprovision
範例: Base64EncodedString...
data.p12
string必填
Base64 P12 證書
範例: Base64EncodedString...
data.state
boolean必填
證書有效狀態（部分分支返回）
範例: true
data.reused
boolean必填
是否復用現有證書（僅在攜帶 code 且滿足同一卡密同一 UDID 可復用時返回）
範例: true
ysucc
string必填
成功標識，成功時返回 "Ysucc"
範例: Ysucc
回應示例
{
"code":1,
"msg":"添加成功",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

錯誤碼

錯誤碼5 個定義
0
token錯誤
Token 無效或已過期
0
UDID格式錯誤
UDID 長度必須為 25 或 40
0
餘額不足
賬戶餘額不足（訊息可能因分支不同而變化）

回應語言

透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。

建議請求標頭
X-Lang: zh-TW
支援的語言
zh, en, zh-TW, vi, ar

也可以使用 Accept-Language；X-Lang 優先級更高。不支援的語言將回退為英文。

程式碼示例

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice" \
  -H "X-Lang: zh-TW" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZ"

注意事項

  • 支援 GET 和 POST（範例使用 POST）
  • 參數通過 Query 或 x-www-form-urlencoded 傳遞，後端不解析 JSON Body
  • shtype 為 warranty 的相容參數，僅在 warranty 為空時使用
  • UDID 僅校驗長度（25 或 40）
  • mobileprovision 與 p12 為 Base64 編碼，需自行解碼儲存
  • warranty=4 時不支援獨立池（type=1）

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

https://testypro.iwai.cc/api/adddevice?token=your_api_token_here&udid=00008030-001234567890ABCD&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 Token

string必填

設備 UDID（長度必須為 25 或 40）

string

售後類型：0=躺平版，1=標準版，2=加強版，3=穩定版，4=擺爛版，6=高擺爛版。建議顯式傳入；缺省或非法值在價格計算中按標準版處理

string

warranty 的別名，僅在 warranty 為空時生效

string

池類型：0=公共池，1=獨立池。預設 0

string

設備類型：iphone 或 ipad。預設 iphone

string

備註（最多 40 個字元，超出截斷）

string

卡密（可選）