POST

v1.1.0stable

Renew Device Membership

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

POST/api/device/membership/renew

অনুমোদন:API Key

সীমা:30/minute

অনুরোধ করা পরামিতি

সকল পরামিতি অনুসন্ধান বা মৃতদেহের মাধ্যমে অতিক্রম করা যাবে

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

প্রতিক্রিয়া

পরামিতি	ধরন	আবশ্যক	বিবরণ
`code`	number	আবশ্যক	Status code: 1=request processed উদাহরণ: 1
`data.total`	number	আবশ্যক	Number of requested device items উদাহরণ: 2
`data.success`	number	আবশ্যক	Successful renewal count উদাহরণ: 2
`data.failed`	number	আবশ্যক	Failed renewal count উদাহরণ: 0
`data.results[].kid`	string	আবশ্যক	Device KID উদাহরণ: KID001
`data.results[].old_expire_time`	number	আবশ্যক	Previous membership expiry timestamp. 0 means permanent উদাহরণ: 1769675945
`data.results[].new_expire_time`	number	আবশ্যক	New membership expiry timestamp. 0 means permanent উদাহরণ: 1772267945
`data.results[].new_expire_at`	string	আবশ্যক	Formatted new expiry time উদাহরণ: 2026-02-28 15:04:05

রেসপন্স উদাহরণ

{

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

}

ত্রুটিপূর্ণ কোড

ত্রুটিপূর্ণ কোড4 নির্ধারিত

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

বহিরাগত ভাষা

X-Lang হেডারের সাথে API প্রতিক্রিয়া গ্রহণ করুন। টি কোড স্বয়ংক্রিয়ভাবে আপনার বর্তমান অবস্থানের জন্য ব্যবহার করা হচ্ছে।

প্রস্তাবিত হেডার

X-Lang: bn

সমর্থিত ভাষা

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

সমর্থিত ভাষাও সমর্থিত নয়; X-Lang এর অগ্রাধিকার গ্রহণ করা হয়। ওয়েব-সাইট ফাইলটির সাহায্যে সমর্থিত হয়।

কোড উদাহরণ

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

নোট

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

কনসোলের মধ্যে এটি চেষ্টা করুন

বাগ পূরণ করুন এবং এটি পরীক্ষা করুন। এই সাইটের API- এ কেবল অনুরোধ করা হয়; URL- টি লক করা হয়েছে এবং আপনার বর্তমান লগ- ইন কুকি অন্তর্ভুক্ত করা যাবে না।

POSThttps://testypro.iwai.cc/api/device/membership/renewএই সাইটের লক করা হয়েছে

tokenstringআবশ্যক

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