GETPOST

v2.2.0stable

Gerät Hinzufügen V2

Einheitliche Single-Device-Add-API. Zwischen Instant- und Reservierungsmodus mit einem Parameter wechseln, während die Legacy-APIs verfügbar bleiben.

GET | POST/api/adddevice/v2

Authentifizierung:API Key

Begrenzung:60/Minute

Anforderungsparameter

Alle Parameter können über Query oder Body übergeben werden

Parameter	Typ	Erforderlich	Beschreibung
`token`	string	Erforderlich	Benutzer-API-Token Beispiel: your_api_token_here
`udid`	string	Erforderlich	Geräte-UDID (muss 25 oder 40 Zeichen lang sein) Beispiel: 00008030-001234567890ABCD
`mode`	string	Optional	Hinzufügungsmodus: sofort oder Überprüfung. Standard ist sofort instantreview Beispiel: instant
`add_mode`	string	Optional	Alias für Modus. Hat Vorrang vor dem Modus instantreview Beispiel: review
`force`	boolean	Optional	Flag erzwingen hinzufügen. true/1/yes/y/on überspringt Überprüfungen von Force-Period und vorhandenen Geräten Beispiel: true
`warranty`	string	Optional	Garantieart: 0/1/2/3/4/6. Überprüfungsmodus unterstützt 4/6 nicht 012346 Beispiel: 1
`shtype`	string	Optional	Alte Alias der Garantie, nur verwendet, wenn Garantie leer ist 012346 Beispiel: 1
`type`	string	Optional	Pool-Typ: 0=öffentlich, 1=privat. Standardwerte folgen der Logik der alten API 01 Beispiel: 0
`deviceType`	string	Optional	Gerätetyp: iPhone oder iPad. Standard iPhone iphoneipad Beispiel: iphone
`beizhu`	string	Optional	Bemerkung Beispiel: 测试设备
`code`	string	Optional	Aktivierungscode (optional) Beispiel: ABC123XYZ

Antwort

Parameter	Typ	Erforderlich	Beschreibung
`code`	number	Erforderlich	Statuscode: 1=Erfolg, 0=Fehler Beispiel: 1
`msg`	string	Erforderlich	Antwortnachricht Beispiel: 添加成功
`data.id`	string	Erforderlich	Zertifikats-ID / Reservierungs-ID Beispiel: AB12CD34
`data.mobileprovision`	string	Erforderlich	Base64 mobileprovision. Kann leer sein, solange die Überprüfung aussteht Beispiel: Base64EncodedString...
`data.p12`	string	Erforderlich	Base64 P12-Zertifikat Beispiel: Base64EncodedString...

Antwortbeispiel

{

"code":1,

"msg":"Gerät erfolgreich hinzugefügt",

"time":1769675945,

"data":

{

"id":"AB12CD34",

"pool":0,

"addtime":1706500000,

"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",

"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"

}

"ysucc":"Ysucc"

}

Fehlercodes

Fehlercodes3 definiert

0

Ungültiges Token

Ungültiges oder abgelaufenes Token

0

Ungültiges UDID-Format

UDID-Länge muss 25 oder 40 sein

0

Innerhalb der Force-Add-Periode

Force=true übergeben, um einen neuen Hinzufügeversuch zu erzwingen

X-Lang: en

zh, en, zh-TW, vi, ar

Codebeispiele

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"
  }'

Hinweise

Die Legacy-Endpunkte /API/adddevice und /API/addyydevice bleiben verfügbar und kompatibel
mode=instant verwendet die Logik für sofortiges Hinzufügen erneut; mode=review verwendet die Logik für Reservierung/Überprüfung erneut
Abfragen, x-www-form-urlencoded und JSON-Body werden unterstützt; JSON-Body wird für V2 empfohlen
force=true überspringt nur lokale force-period / bestehende Kurzschlussprüfungen. Apple kann Duplikate dennoch ablehnen
Der Überprüfungsmodus folgt weiterhin den Beschränkungen der Reservierungs-API, z.B. ist warranty=4/6 nicht unterstützt

Versuchen Sie es in der Konsole

Füllen Sie die untenstehenden Parameter aus und senden Sie eine Anfrage zum Testen. Anfragen gehen nur an die API dieser Seite; die URL ist gesperrt und kann nicht geändert werden, und Ihr aktuelles Login-Cookie ist enthalten.

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

Gesperrt für diese Seite

tokenstringErforderlich

Benutzer-API-Token

udidstringErforderlich

Geräte-UDID (muss 25 oder 40 Zeichen lang sein)

modestring

Hinzufügungsmodus: sofort oder Überprüfung. Standard ist sofort

add_modestring

Alias für Modus. Hat Vorrang vor dem Modus

forceboolean

Flag erzwingen hinzufügen. true/1/yes/y/on überspringt Überprüfungen von Force-Period und vorhandenen Geräten

warrantystring

Garantieart: 0/1/2/3/4/6. Überprüfungsmodus unterstützt 4/6 nicht

shtypestring

Alte Alias der Garantie, nur verwendet, wenn Garantie leer ist

typestring

Pool-Typ: 0=öffentlich, 1=privat. Standardwerte folgen der Logik der alten API

deviceTypestring

Gerätetyp: iPhone oder iPad. Standard iPhone

beizhustring

Bemerkung

codestring

Aktivierungscode (optional)