POST

v1.1.0stable

Renew Device Membership

Batch update device membership expiry with flexible matching and renewal modes.

POST/api/device/membership/renew

Auth:API Key

Limite:30/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

Parametro	Tipo	Obbligo	Descrizione
`token`	string	Obbligo	User API token Esempio: your_api_token_here
`mode`	string	Facoltativo	Renew mode: extend, set, or permanent. Defaults to set when expire_time is provided, otherwise extend extendsetpermanent Esempio: extend
`base`	string	Facoltativo	Extend base: auto, current, or now autocurrentnow Esempio: auto
`days`	number	Facoltativo	Days to add in extend mode Esempio: 30
`seconds`	number	Facoltativo	Seconds to add in extend mode. Higher priority than days Esempio: 2592000
`duration`	string	Facoltativo	Duration expression: 30d, 12h, 60m, or 3600s Esempio: 30d
`expire_time`	number	Facoltativo	New expiry timestamp for set mode, seconds or milliseconds. 0 means permanent Esempio: 1772267945
`kid`	string	Facoltativo	Single device KID Esempio: KID001
`udid`	string	Facoltativo	Single device UDID Esempio: 00008030-001234567890002E
`kids`	array	Facoltativo	Device KID array. Comma/space/newline separated strings are also supported Esempio: KID001,KID002
`udids`	array	Facoltativo	Device UDID array. If one UDID has multiple certificates, match=all updates all by default. Comma/space/newline separated strings are also supported Esempio: 00008030-001234567890002E
`items`	array	Facoltativo	Advanced batch items. Each item can include kid or udid and override mode/base/days/seconds/duration/expire_time Esempio: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}]
`match`	string	Facoltativo	Multiple match handling: all, first, or error. Default all allfirsterror Esempio: all
`continue_on_error`	boolean	Facoltativo	Whether to continue after an item fails. Default true Esempio: true

Risposta

Parametro	Tipo	Obbligo	Descrizione
`code`	number	Obbligo	Status code: 1=request processed Esempio: 1
`data.total`	number	Obbligo	Number of requested device items Esempio: 2
`data.success`	number	Obbligo	Successful renewal count Esempio: 2
`data.failed`	number	Obbligo	Failed renewal count Esempio: 0
`data.results[].kid`	string	Obbligo	Device KID Esempio: KID001
`data.results[].old_expire_time`	number	Obbligo	Previous membership expiry timestamp. 0 means permanent Esempio: 1769675945
`data.results[].new_expire_time`	number	Obbligo	New membership expiry timestamp. 0 means permanent Esempio: 1772267945
`data.results[].new_expire_at`	string	Obbligo	Formatted new expiry time Esempio: 2026-02-28 15:04:05

Esempio di risposta

{

"code":1,

"msg":"Device membership renewal processed",

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

}

Batch extend 30 days by KID

Use comma-separated kids with extend mode

Batch extend 30 days by KID

{

"token":"your_api_token_here",

"kids":"KID001,KID002",

"mode":"extend",

"days":30

}

Batch extend by UDID

For scenarios where only UDIDs are available. Multiple certificates under one UDID are updated by default

Batch extend by UDID

{

"token":"your_api_token_here",

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

"mode":"extend",

"duration":"60d"

}

Set explicit expiry time

Use mode=set to set an explicit membership expiry timestamp

Set explicit expiry time

{

"token":"your_api_token_here",

"kid":"KID001",

"mode":"set",

"expire_time":1772267945

}

Set permanent

Use mode=permanent to make membership permanent

Set permanent

{

"token":"your_api_token_here",

"kid":"KID001",

"mode":"permanent"

}

Per-device strategy

Each item can override global renewal options

Per-device strategy

{

"token":"your_api_token_here",

"items":

[

{

"kid":"KID001",

"mode":"extend",

"days":30

}

{

"kid":"KID002",

"mode":"set",

"expire_time":1772267945

}

{

"udid":"00008030-001234567890002E",

"mode":"permanent"

}

]

}

Only update latest match for a UDID

With match=first, only the latest matched certificate under the same UDID is updated

Only update latest match for a UDID

{

"token":"your_api_token_here",

"udid":"00008030-001234567890002E",

"mode":"extend",

"days":30,

"match":"first"

}

Codici di errore

Codici di errore4 definito

12

Token is required

Missing token parameter

20

Please provide at least one device

Missing kid, kids, udid, udids, or items

21

Invalid mode, valid values: extend/set/permanent

Invalid renewal mode

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata

X-Lang: it

Lingue supportate

zh, en, zh-TW, vi, ar, es, ru

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/membership/renew" \
  -H "X-Lang: it" \
  -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
  }'

Note

该接口仅更新设备会员/证书下载权益到期时间，不会重新签名或扣款
0 表示永久有效；extend 遇到永久有效设备时默认保持永久，可用 base=now 强制改为从当前时间延长
UDID 命中多条证书时默认 match=all 全部更新，可传 first 或 error 改变行为
支持 JSON 请求，也支持表单参数；表单 items 可传 JSON 数组字符串

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

POSThttps://testypro.iwai.cc/api/device/membership/renewBloccato a questo sito

tokenstringObbligo

User API token

modestring

Renew mode: extend, set, or permanent. Defaults to set when expire_time is provided, otherwise extend

basestring

Extend base: auto, current, or now

daysnumber

Days to add in extend mode

secondsnumber

Seconds to add in extend mode. Higher priority than days

durationstring

Duration expression: 30d, 12h, 60m, or 3600s

expire_timenumber

New expiry timestamp for set mode, seconds or milliseconds. 0 means permanent

kidstring

Single device KID

udidstring

Single device UDID

kidsarray

Device KID array. Comma/space/newline separated strings are also supported

udidsarray

Device UDID array. If one UDID has multiple certificates, match=all updates all by default. Comma/space/newline separated strings are also supported

itemsarray

Advanced batch items. Each item can include kid or udid and override mode/base/days/seconds/duration/expire_time

matchstring

Multiple match handling: all, first, or error. Default all

continue_on_errorboolean

Whether to continue after an item fails. Default true