GETPOST
v2.2.0stable

Ajouter un Appareil V2

API unifiée d'ajout de périphérique unique. Basculez entre le mode instantané et le mode réservation avec un seul paramètre tout en gardant les API héritées disponibles.

GET | POST/api/adddevice/v2
Authentification:API Key
Limite:60/minute

Paramètres de la requête

Tous les paramètres peuvent être transmis via Query ou Body

ParamètreTypeRequisDescription
token
stringRequis
Jeton API utilisateur
Exemple: your_api_token_here
udid
stringRequis
UDID du périphérique (doit comporter 25 ou 40 caractères)
Exemple: 00008030-001234567890ABCD
mode
stringOptionnel
Mode d'ajout : instantané ou revue. Par défaut, c'est instantané
instantreview
Exemple: instant
add_mode
stringOptionnel
Alias du mode. Prend la priorité sur le mode
instantreview
Exemple: review
force
booleanOptionnel
Ajouter le drapeau de force. true/1/yes/y/on ignore les vérifications de période forcée et de circuit court sur les périphériques existants
Exemple: true
warranty
stringOptionnel
Type de garantie : 0/1/2/3/4/6. le mode de révision ne prend pas en charge 4/6
012346
Exemple: 1
shtype
stringOptionnel
Alias hérité de la garantie, utilisé uniquement lorsque la garantie est vide
012346
Exemple: 1
type
stringOptionnel
Type de pool : 0=public, 1=privé. Les valeurs par défaut suivent la logique de l'API héritée
01
Exemple: 0
deviceType
stringOptionnel
Type de périphérique : iphone ou ipad. Par défaut iphone
iphoneipad
Exemple: iphone
beizhu
stringOptionnel
Remarque
Exemple: 测试设备
code
stringOptionnel
Code d'activation (optionnel)
Exemple: ABC123XYZ

Réponse

ParamètreTypeRequisDescription
code
numberRequis
Code d'état : 1=succès, 0=échec
Exemple: 1
msg
stringRequis
Message de réponse
Exemple: 添加成功
data.id
stringRequis
ID du certificat / ID de réservation
Exemple: AB12CD34
data.mobileprovision
stringRequis
mobileprovision Base64. Peut être vide pendant l'examen en attente
Exemple: Base64EncodedString...
data.p12
stringRequis
Certificat P12 Base64
Exemple: Base64EncodedString...
Exemple de réponse
{
"code":1,
"msg":"Appareil ajouté avec succès",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Codes d'erreur

Codes d'erreur3 défini
0
Jeton invalide
Jeton invalide ou expiré
0
Format UDID invalide
La longueur de l'UDID doit être de 25 ou 40
0
Pendant la période d'ajout forcé
Passez force=true pour forcer une nouvelle tentative d'ajout

X-Lang: en
zh, en, zh-TW, vi, ar

Exemples de code

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

Remarques

  • Les anciennes API /API/adddevice et /API/addyydevice restent disponibles et compatibles
  • mode=instant réutilise la logique d'ajout instantané ; mode=review réutilise la logique d'ajout réservation/revue
  • Les requêtes, x-www-form-urlencoded et le corps JSON sont pris en charge ; le corps JSON est recommandé pour V2
  • force=true ne contourne que les vérifications locales de période de force/existant. Apple peut toujours rejeter les doublons
  • le mode de révision suit toujours les restrictions de l'API de réservation, par exemple garantie=4/6 n'est pas pris en charge

Essayez-le dans la Console

Remplissez les paramètres ci-dessous et envoyez une requête pour tester. Les requêtes ne vont qu'à l'API de ce site ; l'URL est verrouillée et ne peut pas être modifiée, et votre cookie de connexion actuel est inclus.

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=ABC123XYZVerrouillé sur ce site
stringRequis

Jeton API utilisateur

stringRequis

UDID du périphérique (doit comporter 25 ou 40 caractères)

string

Mode d'ajout : instantané ou revue. Par défaut, c'est instantané

string

Alias du mode. Prend la priorité sur le mode

boolean

Ajouter le drapeau de force. true/1/yes/y/on ignore les vérifications de période forcée et de circuit court sur les périphériques existants

string

Type de garantie : 0/1/2/3/4/6. le mode de révision ne prend pas en charge 4/6

string

Alias hérité de la garantie, utilisé uniquement lorsque la garantie est vide

string

Type de pool : 0=public, 1=privé. Les valeurs par défaut suivent la logique de l'API héritée

string

Type de périphérique : iphone ou ipad. Par défaut iphone

string

Remarque

string

Code d'activation (optionnel)