POST

v1.1.0stable

Renew Device Membership

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

POST/api/device/membership/renew

Ang Auth:API Key

Hangganan:30/minute

Kahilingan ng mga Parameter

Ang lahat ng parameter ay maaaring ipasa sa pamamagitan ng Query o Body

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

Pagtugon

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

Pagtugon na Halimbawa

{

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

}

Error

Error4 Binigyang - katuturan

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

Pagtugon sa Wika

Ang mga code na halimbawa sa ibaba ay awtomatikong gumagamit ng kasalukuyang site language mo.

Inirerekomendang Tagapangulo

X-Lang: fil

Suportadong mga Wika

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

Sinusuportahan din ang tinatanggap na-Language; ang X-Lang ang inuuna. ang mga hindi suportadong wika ay sumusunod sa site language fallback.

Mga Halimbawa ng Kodigo

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

Mga Noble

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

Subukin ito sa Console

Punan ang mga parameter sa ibaba at magpadala ng kahilingan upang masubukan. requests pumunta lamang sa API ng site na ito; ang URL ay naka-lock at hindi maaaring baguhin, at isama ang inyong kasalukuyang login cookie.

POSThttps://testypro.iwai.cc/api/device/membership/renewNakakandado sa lugar na ito

tokenstringKailangan

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