POST

v1.1.0stable

Gerätemitgliedschaft Verlängern

Sammelaktualisierung des Ablaufdatums der Gerätemitgliedschaft mit flexiblen Abgleich- und Erneuerungsmodi.

POST/api/device/membership/renew

Authentifizierung:API Key

Begrenzung:30/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
`mode`	string	Optional	Erneuerungsmodus: verlängern, setzen oder dauerhaft. Standard ist setzen, wenn expire_time angegeben ist, sonst verlängern extendsetpermanent Beispiel: extend
`base`	string	Optional	Basis der Verlängerung: automatisch, aktuell oder jetzt autocurrentnow Beispiel: auto
`days`	number	Optional	Zu addierende Tage im Verlängerungsmodus Beispiel: 30
`seconds`	number	Optional	Zu addierende Sekunden im Verlängerungsmodus. Hat höhere Priorität als Tage Beispiel: 2592000
`duration`	string	Optional	Dauerangabe: 30d, 12h, 60m oder 3600s Beispiel: 30d
`expire_time`	number	Optional	Neuer Ablaufzeitstempel für den Set-Modus, Sekunden oder Millisekunden. 0 bedeutet dauerhaft Beispiel: 1772267945
`kid`	string	Optional	Einzelnes Geräte-KID Beispiel: KID001
`udid`	string	Optional	Einzelnes Geräte-UDID Beispiel: 00008030-001234567890002E
`kids`	array	Optional	Geräte-KID-Array. Komma-/Leerzeichen-/Zeilenumbruch-getrennte Zeichenfolgen werden ebenfalls unterstützt Beispiel: KID001,KID002
`udids`	array	Optional	Geräte-UDID-Array. Wenn eine UDID mehrere Zertifikate hat, match=all aktualisiert standardmäßig alle. Komma-/Leerzeichen-/Zeilenumbruch-getrennte Zeichenfolgen werden ebenfalls unterstützt Beispiel: 00008030-001234567890002E
`items`	array	Optional	Erweiterte Batch-Elemente. Jedes Element kann KID oder UDID enthalten und Modus/Basis/Tage/Sekunden/Dauer/Ablaufzeit überschreiben Beispiel: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}]
`match`	string	Optional	Mehrfachübereinstimmung: all, first oder error. Standard ist all allfirsterror Beispiel: all
`continue_on_error`	boolean	Optional	Ob nach einem Fehler bei einem Element fortgesetzt werden soll. Standardwert true Beispiel: true

Antwort

Parameter	Typ	Erforderlich	Beschreibung
`code`	number	Erforderlich	Statuscode: 1=Anfrage verarbeitet Beispiel: 1
`data.total`	number	Erforderlich	Anzahl der angeforderten Geräteartikel Beispiel: 2
`data.success`	number	Erforderlich	Anzahl erfolgreicher Verlängerungen Beispiel: 2
`data.failed`	number	Erforderlich	Anzahl fehlgeschlagener Verlängerungen Beispiel: 0
`data.results[].kid`	string	Erforderlich	Geräte-KID Beispiel: KID001
`data.results[].old_expire_time`	number	Erforderlich	Vorheriger Mitgliedschaftsablauf-Zeitstempel. 0 bedeutet dauerhaft Beispiel: 1769675945
`data.results[].new_expire_time`	number	Erforderlich	Neuer Mitgliedschaftsablauf-Zeitstempel. 0 bedeutet dauerhaft Beispiel: 1772267945
`data.results[].new_expire_at`	string	Erforderlich	Formatiertes neues Ablaufdatum Beispiel: 2026-02-28 15:04:05

Antwortbeispiel

{

"code":1,

"msg":"Geräte-Mitgliedschaftsverlängerung verarbeitet",

"time":1769675945,

"data":

{

"total":2,

"processed_results":2,

"success":2,

"failed":0,

"continue_on_error":true,

"match":"all",

"results":

[

{

"index":0,

"kid":"KID001",

"udid":"00008030-001234567890002E",

"success":true,

"code":1,

"msg":"续期成功",

"old_expire_time":1769675945,

"new_expire_time":1772267945,

"old_expire_at":"2026-01-29 15:04:05",

"new_expire_at":"2026-02-28 15:04:05",

"changed":true,

"matched_count":1

}

{

"index":1,

"kid":"KID002",

"udid":"00008030-009876543210002E",

"success":true,

"code":1,

"msg":"续期成功",

"old_expire_time":0,

"new_expire_time":0,

"old_expire_at":"permanent",

"new_expire_at":"permanent",

"changed":false,

"matched_count":1

}

]

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Stapelweise Verlängerung um 30 Tage nach KID

Verwenden Sie durch Komma getrennte KIDs mit Verlängerungsmodus

Stapelweise Verlängerung um 30 Tage nach KID

{

"token":"your_api_token_here",

"kids":"KID001,KID002",

"mode":"extend",

"days":30

}

Stapelweise Verlängerung nach UDID

Für Szenarien, in denen nur UDIDs verfügbar sind. Mehrere Zertifikate unter einer UDID werden standardmäßig aktualisiert

Stapelweise Verlängerung nach UDID

{

"token":"your_api_token_here",

"udids":"00008030-001234567890002E,00008030-009876543210002E",

"mode":"extend",

"duration":"60d"

}

Explizite Ablaufzeit festlegen

Verwenden Sie mode=set, um einen expliziten Mitgliedschafts-Ablaufzeitstempel festzulegen

Explizite Ablaufzeit festlegen

{

"token":"your_api_token_here",

"kid":"KID001",

"mode":"set",

"expire_time":1772267945

}

Permanent festlegen

Verwenden Sie mode=permanent, um die Mitgliedschaft dauerhaft zu machen

Permanent festlegen

{

"token":"your_api_token_here",

"kid":"KID001",

"mode":"permanent"

}

Gerätebasierte Strategie

Jeder Eintrag kann globale Erneuerungsoptionen überschreiben

Gerätebasierte Strategie

{

"token":"your_api_token_here",

"items":

[

{

"kid":"KID001",

"mode":"extend",

"days":30

}

{

"kid":"KID002",

"mode":"set",

"expire_time":1772267945

}

{

"udid":"00008030-001234567890002E",

"mode":"permanent"

}

]

}

Nur das neueste Matching für eine UDID aktualisieren

Mit match=first wird nur das zuletzt unter derselben UDID gefundene Zertifikat aktualisiert

Nur das neueste Matching für eine UDID aktualisieren

{

"token":"your_api_token_here",

"udid":"00008030-001234567890002E",

"mode":"extend",

"days":30,

"match":"first"

}

Fehlercodes

Fehlercodes4 definiert

12

Token ist erforderlich

Fehlender Token-Parameter

20

Bitte geben Sie mindestens ein Gerät an

Fehlendes kid, kids, UDID, udids oder items

21

Ungültiger Modus, gültige Werte: extend/set/permanent

Ungültiger Verlängerungsmodus

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

Hinweise

Diese API aktualisiert nur die Mitgliedschaft des Geräts/den Ablauf des Zertifikatdownloads. Sie signiert nicht neu und belastet kein Guthaben
0 bedeutet dauerhaft. Im Erweiterungsmodus bleiben permanente Geräte standardmäßig dauerhaft; verwenden Sie base=now, um ein befristetes Ablaufdatum zu erzwingen
Wenn eine UDID mit mehreren Zertifikaten übereinstimmt, aktualisiert match=all standardmäßig alle. Verwenden Sie first oder error, um das Verhalten zu ändern
Sowohl JSON- als auch Formularanfragen werden unterstützt. Formularfelder können ein JSON-Array-String sein

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.

POSThttps://testypro.iwai.cc/api/device/membership/renewGesperrt für diese Seite

tokenstringErforderlich

Benutzer-API-Token

modestring

Erneuerungsmodus: verlängern, setzen oder dauerhaft. Standard ist setzen, wenn expire_time angegeben ist, sonst verlängern

basestring

Basis der Verlängerung: automatisch, aktuell oder jetzt

daysnumber

Zu addierende Tage im Verlängerungsmodus

secondsnumber

Zu addierende Sekunden im Verlängerungsmodus. Hat höhere Priorität als Tage

durationstring

Dauerangabe: 30d, 12h, 60m oder 3600s

expire_timenumber

Neuer Ablaufzeitstempel für den Set-Modus, Sekunden oder Millisekunden. 0 bedeutet dauerhaft

kidstring

Einzelnes Geräte-KID

udidstring

Einzelnes Geräte-UDID

kidsarray

Geräte-KID-Array. Komma-/Leerzeichen-/Zeilenumbruch-getrennte Zeichenfolgen werden ebenfalls unterstützt

udidsarray

Geräte-UDID-Array. Wenn eine UDID mehrere Zertifikate hat, match=all aktualisiert standardmäßig alle. Komma-/Leerzeichen-/Zeilenumbruch-getrennte Zeichenfolgen werden ebenfalls unterstützt

itemsarray

Erweiterte Batch-Elemente. Jedes Element kann KID oder UDID enthalten und Modus/Basis/Tage/Sekunden/Dauer/Ablaufzeit überschreiben

matchstring

Mehrfachübereinstimmung: all, first oder error. Standard ist all

continue_on_errorboolean

Ob nach einem Fehler bei einem Element fortgesetzt werden soll. Standardwert true