Renouveler l’Adhésion de l’Appareil
Mise à jour par lot de la date d'expiration de l'adhésion des appareils avec des modes de correspondance et de renouvellement flexibles.
/api/device/membership/renewParamètres de la requête
Tous les paramètres peuvent être transmis via Query ou Body
| Paramètre | Type | Requis | Description |
|---|---|---|---|
token | string | Requis | Jeton API utilisateur Exemple: your_api_token_here |
mode | string | Optionnel | Mode de renouvellement : étendre, définir ou permanent. Par défaut, défini lorsque expire_time est fourni, sinon étendre extendsetpermanent Exemple: extend |
base | string | Optionnel | Étendre la base : auto, actuel ou maintenant autocurrentnow Exemple: auto |
days | number | Optionnel | Jours à ajouter en mode étendre Exemple: 30 |
seconds | number | Optionnel | Secondes à ajouter en mode étendre. Priorité plus élevée que les jours Exemple: 2592000 |
duration | string | Optionnel | Expression de durée : 30j, 12h, 60m ou 3600s Exemple: 30d |
expire_time | number | Optionnel | Nouvel horodatage d'expiration pour le mode définir, en secondes ou en millisecondes. 0 signifie permanent Exemple: 1772267945 |
kid | string | Optionnel | KID d'un seul appareil Exemple: KID001 |
udid | string | Optionnel | UDID d'un seul appareil Exemple: 00008030-001234567890002E |
kids | array | Optionnel | Tableau des KID de l'appareil. Les chaînes séparées par des virgules, des espaces ou des sauts de ligne sont également prises en charge Exemple: KID001,KID002 |
udids | array | Optionnel | Tableau des UDID de l'appareil. Si un UDID possède plusieurs certificats, match=all met à jour tous par défaut. Les chaînes séparées par des virgules, des espaces ou des sauts de ligne sont également prises en charge Exemple: 00008030-001234567890002E |
items | array | Optionnel | Éléments de lot avancés. Chaque élément peut inclure kid ou UDID et remplacer mode/base/jours/secondes/durée/heure_d'expiration Exemple: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}] |
match | string | Optionnel | Gestion multiple des correspondances : all, first, ou error. Par défaut all allfirsterror Exemple: all |
continue_on_error | boolean | Optionnel | Indique si le processus doit continuer après l'échec d'un élément. Par défaut vrai Exemple: true |
Réponse
| Paramètre | Type | Requis | Description |
|---|---|---|---|
code | number | Requis | Code d'état : 1 = demande traitée Exemple: 1 |
data.total | number | Requis | Nombre d'articles de périphérique demandés Exemple: 2 |
data.success | number | Requis | Nombre de renouvellements réussis Exemple: 2 |
data.failed | number | Requis | Nombre de renouvellements échoués Exemple: 0 |
data.results[].kid | string | Requis | KID de l'appareil Exemple: KID001 |
data.results[].old_expire_time | number | Requis | Horodatage d'expiration de l'abonnement précédent. 0 signifie permanent Exemple: 1769675945 |
data.results[].new_expire_time | number | Requis | Nouvel horodatage d'expiration de l'abonnement. 0 signifie permanent Exemple: 1772267945 |
data.results[].new_expire_at | string | Requis | Heure d'expiration formatée Exemple: 2026-02-28 15:04:05 |
Extension de lot de 30 jours par KID
Utilisez des KID séparés par des virgules avec le mode d'extension
Extension de lot par UDID
Pour les scénarios où seuls les UDID sont disponibles. Plusieurs certificats sous un seul UDID sont mis à jour par défaut
Définir une date d'expiration explicite
Utiliser mode=set pour définir un horodatage d'expiration d'adhésion explicite
Définir permanent
Utiliser mode=permanent pour rendre l'adhésion permanente
Stratégie par appareil
Chaque élément peut remplacer les options de renouvellement globales
Mettre à jour uniquement la correspondance la plus récente pour un UDID
Avec match=first, seul le dernier certificat correspondant sous le même UDID est mis à jour
Codes d'erreur
122021X-Lang: enzh, en, zh-TW, vi, arExemples de code
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/membership/renew" \
-H "X-Lang: en" \
-H "Content-Type: application/json" \
-d '{
"token": "your_api_token_here",
"mode": "extend",
"base": "auto",
"days": 30,
"seconds": 2592000,
"duration": "30d",
"expire_time": 1772267945,
"kid": "KID001",
"udid": "00008030-001234567890002E",
"kids": "KID001,KID002",
"udids": "00008030-001234567890002E",
"items": "[{\"kid\":\"KID001\",\"mode\":\"extend\",\"days\":30},{\"udid\":\"00008030-001234567890002E\",\"mode\":\"permanent\"}]",
"match": "all",
"continue_on_error": true
}'Remarques
- Cette API met uniquement à jour l'adhésion de l'appareil/la date d'expiration du téléchargement du certificat. Elle ne signe pas à nouveau ni ne débite le solde
- 0 signifie permanent. En mode extension, les appareils permanents restent permanents par défaut ; utilisez base=now pour forcer une expiration limitée
- Lorsque un UDID correspond à plusieurs certificats, match=all met à jour tous par défaut. Utilisez first ou error pour changer le comportement
- Les requêtes JSON et de formulaire sont toutes deux prises en charge. Les éléments de formulaire peuvent être une chaîne de tableau JSON
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/device/membership/renewVerrouillé sur ce siteJeton API utilisateur
Mode de renouvellement : étendre, définir ou permanent. Par défaut, défini lorsque expire_time est fourni, sinon étendre
Étendre la base : auto, actuel ou maintenant
Jours à ajouter en mode étendre
Secondes à ajouter en mode étendre. Priorité plus élevée que les jours
Expression de durée : 30j, 12h, 60m ou 3600s
Nouvel horodatage d'expiration pour le mode définir, en secondes ou en millisecondes. 0 signifie permanent
KID d'un seul appareil
UDID d'un seul appareil
Tableau des KID de l'appareil. Les chaînes séparées par des virgules, des espaces ou des sauts de ligne sont également prises en charge
Tableau des UDID de l'appareil. Si un UDID possède plusieurs certificats, match=all met à jour tous par défaut. Les chaînes séparées par des virgules, des espaces ou des sauts de ligne sont également prises en charge
Éléments de lot avancés. Chaque élément peut inclure kid ou UDID et remplacer mode/base/jours/secondes/durée/heure_d'expiration
Gestion multiple des correspondances : all, first, ou error. Par défaut all
Indique si le processus doit continuer après l'échec d'un élément. Par défaut vrai