POST

v1.1.0stable

Cihaz Üyeliğini Yenile

Esnek eşleştirme ve yenileme modları ile cihaz üyeliği süresini toplu olarak güncelleyin.

POST/api/device/membership/renew

Yetkilendirme:API Key

Limit:30/dakika

İstek Parametreleri

Tüm parametreler Sorgu veya Gövde üzerinden iletilebilir

Parametre	Tür	Gerekli	Açıklama
`token`	string	Gerekli	Kullanıcı API token'ı Örnek: your_api_token_here
`mode`	string	İsteğe bağlı	Yenileme modu: uzat, ayarla veya kalıcı. expire_time sağlandığında varsayılan ayar ayarla, aksi takdirde uzat extendsetpermanent Örnek: extend
`base`	string	İsteğe bağlı	Uzatma tabanı: otomatik, mevcut veya şimdi autocurrentnow Örnek: auto
`days`	number	İsteğe bağlı	Uzatma modunda eklenecek gün sayısı Örnek: 30
`seconds`	number	İsteğe bağlı	Uzatma modunda eklenecek saniye sayısı. Günlerden daha yüksek öncelik Örnek: 2592000
`duration`	string	İsteğe bağlı	Süre ifadesi: 30g, 12s, 60d veya 3600s Örnek: 30d
`expire_time`	number	İsteğe bağlı	Ayarlama modu için yeni sona erme zaman damgası, saniye veya milisaniye. 0 kalıcı anlamına gelir Örnek: 1772267945
`kid`	string	İsteğe bağlı	Tek cihaz KID Örnek: KID001
`udid`	string	İsteğe bağlı	Tek cihaz UDID Örnek: 00008030-001234567890002E
`kids`	array	İsteğe bağlı	Cihaz KID dizisi. Virgül/boşluk/yeni satır ile ayrılmış dizeler de desteklenir Örnek: KID001,KID002
`udids`	array	İsteğe bağlı	Cihaz UDID dizisi. Bir UDID birden fazla sertifikaya sahipse, match=all varsayılan olarak hepsini günceller. Virgül/boşluk/yeni satır ile ayrılmış dizeler de desteklenir Örnek: 00008030-001234567890002E
`items`	array	İsteğe bağlı	Gelişmiş toplu öğeler. Her öğe kid veya UDID içerebilir ve mod/base/gün/saniye/süre/expire_time değerlerini geçersiz kılabilir Örnek: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}]
`match`	string	İsteğe bağlı	Birden fazla eşleşme işleme: all, first veya error. Varsayılan all allfirsterror Örnek: all
`continue_on_error`	boolean	İsteğe bağlı	Bir öğe başarısız olursa devam edilip edilmeyeceği. Varsayılan true Örnek: true

Yanıt

Parametre	Tür	Gerekli	Açıklama
`code`	number	Gerekli	Durum kodu: 1=işlem işleme alındı Örnek: 1
`data.total`	number	Gerekli	Talep edilen cihaz öğesi sayısı Örnek: 2
`data.success`	number	Gerekli	Başarılı yenileme sayısı Örnek: 2
`data.failed`	number	Gerekli	Başarısız yenileme sayısı Örnek: 0
`data.results[].kid`	string	Gerekli	Cihaz KID Örnek: KID001
`data.results[].old_expire_time`	number	Gerekli	Önceki üyelik süresi bitiş zaman damgası. 0 kalıcı anlamına gelir Örnek: 1769675945
`data.results[].new_expire_time`	number	Gerekli	Yeni üyelik süresi bitiş zaman damgası. 0 kalıcı anlamına gelir Örnek: 1772267945
`data.results[].new_expire_at`	string	Gerekli	Yeni bitiş süresinin formatlanmış zamanı Örnek: 2026-02-28 15:04:05

Yanıt Örneği

{

"code":1,

"msg":"Cihaz üyelik yenileme işlendi",

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

}

KID ile toplu 30 gün uzatma

Uzatma modu ile virgülle ayrılmış kidleri kullanın

KID ile toplu 30 gün uzatma

{

"token":"your_api_token_here",

"kids":"KID001,KID002",

"mode":"extend",

"days":30

}

UDID ile toplu uzatma

Sadece UDID'lerin mevcut olduğu senaryolar için. Bir UDID altında birden fazla sertifika varsayılan olarak güncellenir

UDID ile toplu uzatma

{

"token":"your_api_token_here",

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

"mode":"extend",

"duration":"60d"

}

Açık sona erme süresi ayarlayın

Belirli bir üyelik sona erme zaman damgası ayarlamak için mode=set kullanın

Açık sona erme süresi ayarlayın

{

"token":"your_api_token_here",

"kid":"KID001",

"mode":"set",

"expire_time":1772267945

}

Kalıcı ayarlayın

Üyeliği kalıcı yapmak için mode=permanent kullanın

Kalıcı ayarlayın

{

"token":"your_api_token_here",

"kid":"KID001",

"mode":"permanent"

}

Cihaz başına strateji

Her öğe genel yenileme seçeneklerini geçersiz kılabilir

Cihaz başına strateji

{

"token":"your_api_token_here",

"items":

[

{

"kid":"KID001",

"mode":"extend",

"days":30

}

{

"kid":"KID002",

"mode":"set",

"expire_time":1772267945

}

{

"udid":"00008030-001234567890002E",

"mode":"permanent"

}

]

}

Bir UDID için sadece en son eşleşmeyi güncelle

match=first ile, aynı UDID altında yalnızca en son eşleşen sertifika güncellenir

Bir UDID için sadece en son eşleşmeyi güncelle

{

"token":"your_api_token_here",

"udid":"00008030-001234567890002E",

"mode":"extend",

"days":30,

"match":"first"

}

Hata Kodları

Hata Kodları4 tanımlandı

12

Token gereklidir

Eksik token parametresi

20

Lütfen en az bir cihaz sağlayın

kid, kids, UDID, udids veya items eksik

21

Geçersiz mod, geçerli değerler: extend/set/permanent

Geçersiz yenileme modu

X-Lang: en

zh, en, zh-TW, vi, ar

Kod Örnekleri

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

Notlar

Bu API yalnızca cihaz üyeliği/sertifika indirme süresini günceller. Yeniden imzalamaz veya bakiye ücretini tahsil etmez
0 kalıcı anlamına gelir. Uzatma modunda, kalıcı cihazlar varsayılan olarak kalıcı kalır; sınırlı bir sürenin sona ermesini zorlamak için base=now kullanın
Bir UDID birden fazla sertifika ile eşleştiğinde, match=all varsayılan olarak tümünü günceller. Davranışı değiştirmek için first veya error kullanın
Hem JSON hem de form istekleri desteklenir. Form öğeleri JSON dizi stringi olabilir

Konsolda deneyin

Aşağıdaki parametreleri doldurun ve testi yapmak için bir istek gönderin. İstekler yalnızca bu sitenin API'sine gider; URL kilitli ve değiştirilemez, mevcut giriş çereziniz dahil edilir.

POSThttps://testypro.iwai.cc/api/device/membership/renewBu siteye kilitli

tokenstringGerekli

Kullanıcı API token'ı

modestring

Yenileme modu: uzat, ayarla veya kalıcı. expire_time sağlandığında varsayılan ayar ayarla, aksi takdirde uzat

basestring

Uzatma tabanı: otomatik, mevcut veya şimdi

daysnumber

Uzatma modunda eklenecek gün sayısı

secondsnumber

Uzatma modunda eklenecek saniye sayısı. Günlerden daha yüksek öncelik

durationstring

Süre ifadesi: 30g, 12s, 60d veya 3600s

expire_timenumber

Ayarlama modu için yeni sona erme zaman damgası, saniye veya milisaniye. 0 kalıcı anlamına gelir

kidstring

Tek cihaz KID

udidstring

Tek cihaz UDID

kidsarray

Cihaz KID dizisi. Virgül/boşluk/yeni satır ile ayrılmış dizeler de desteklenir

udidsarray

Cihaz UDID dizisi. Bir UDID birden fazla sertifikaya sahipse, match=all varsayılan olarak hepsini günceller. Virgül/boşluk/yeni satır ile ayrılmış dizeler de desteklenir

itemsarray

Gelişmiş toplu öğeler. Her öğe kid veya UDID içerebilir ve mod/base/gün/saniye/süre/expire_time değerlerini geçersiz kılabilir

matchstring

Birden fazla eşleşme işleme: all, first veya error. Varsayılan all

continue_on_errorboolean

Bir öğe başarısız olursa devam edilip edilmeyeceği. Varsayılan true