डिवाइस सदस्यता नवीनीकृत करें
लचीले मिलान और नवीनीकरण मोड के साथ डिवाइस सदस्यता की समय सीमा बैच अपडेट करें।
/api/device/membership/renewअनुरोध पैरामीटर
सभी पैरामीटर क्वेरी या बॉडी के माध्यम से भेजे जा सकते हैं
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
token | string | आवश्यक | उपयोगकर्ता API टोकन उदाहरण: your_api_token_here |
mode | string | वैकल्पिक | नवीनीकरण मोड: विस्तारित करें, सेट करें, या स्थायी। expire_time प्रदान किए जाने पर डिफ़ॉल्ट सेट होता है, अन्यथा विस्तारित करें extendsetpermanent उदाहरण: extend |
base | string | वैकल्पिक | विस्तारित आधार: स्वचालित, वर्तमान, या अब autocurrentnow उदाहरण: auto |
days | number | वैकल्पिक | विस्तारित मोड में जोड़ने के लिए दिन उदाहरण: 30 |
seconds | number | वैकल्पिक | विस्तारित मोड में जोड़ने के लिए सेकंड। दिनों की तुलना में अधिक प्राथमिकता उदाहरण: 2592000 |
duration | string | वैकल्पिक | अवधि अभिव्यक्ति: 30d, 12h, 60m, या 3600s उदाहरण: 30d |
expire_time | number | वैकल्पिक | सेट मोड के लिए नया समाप्ति टाइमस्टैम्प, सेकंड या मिलीसेकंड में। 0 का मतलब स्थायी है उदाहरण: 1772267945 |
kid | string | वैकल्पिक | एकल डिवाइस KID उदाहरण: KID001 |
udid | string | वैकल्पिक | एकल डिवाइस UDID उदाहरण: 00008030-001234567890002E |
kids | array | वैकल्पिक | डिवाइस KID एरे। कॉमा/स्पेस/न्यूलाइन से अलग किए गए स्ट्रिंग्स का भी समर्थन किया जाता है उदाहरण: KID001,KID002 |
udids | array | वैकल्पिक | डिवाइस UDID एरे। यदि एक UDID के पास कई प्रमाणपत्र हैं, तो match=all डिफ़ॉल्ट रूप से सभी को अपडेट करता है। कॉमा/स्पेस/न्यूलाइन से अलग किए गए स्ट्रिंग्स का भी समर्थन किया जाता है उदाहरण: 00008030-001234567890002E |
items | array | वैकल्पिक | उन्नत बैच आइटम। प्रत्येक आइटम में kid या UDID और override mode/base/days/seconds/duration/expire_time शामिल हो सकते हैं उदाहरण: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}] |
match | string | वैकल्पिक | कई मैच हैंडलिंग: all, first, या error। डिफ़ॉल्ट all allfirsterror उदाहरण: all |
continue_on_error | boolean | वैकल्पिक | क्या किसी आइटम के फेल होने के बाद जारी रखना है। डिफ़ॉल्ट सत्य उदाहरण: true |
प्रतिक्रिया
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
code | number | आवश्यक | स्थिति कोड: 1=अनुरोध संसाधित किया गया उदाहरण: 1 |
data.total | number | आवश्यक | अनुरोधित डिवाइस आइटमों की संख्या उदाहरण: 2 |
data.success | number | आवश्यक | सफल नवीकरण संख्या उदाहरण: 2 |
data.failed | number | आवश्यक | असफल नवीकरण संख्या उदाहरण: 0 |
data.results[].kid | string | आवश्यक | डिवाइस KID उदाहरण: KID001 |
data.results[].old_expire_time | number | आवश्यक | पिछली सदस्यता समाप्ति समय। 0 का अर्थ स्थायी है उदाहरण: 1769675945 |
data.results[].new_expire_time | number | आवश्यक | नई सदस्यता समाप्ति समय। 0 का अर्थ स्थायी है उदाहरण: 1772267945 |
data.results[].new_expire_at | string | आवश्यक | स्वरूपित नई समाप्ति समय उदाहरण: 2026-02-28 15:04:05 |
KID द्वारा बैच 30 दिन बढ़ाना
बढ़ाने के मोड के साथ कॉमा से अलग किए गए KID का उपयोग करें
UDID द्वारा बैच बढ़ाएं
केवल UDID उपलब्ध होने वाले परिदृश्यों के लिए। एक UDID के तहत कई प्रमाणपत्र डिफ़ॉल्ट रूप से अपडेट किए जाते हैं
स्पष्ट समाप्ति समय सेट करें
स्पष्ट सदस्यता समाप्ति समय सेट करने के लिए mode=set का उपयोग करें
स्थायी सेट करें
सदस्यता को स्थायी बनाने के लिए mode=permanent का उपयोग करें
प्रति-डिवाइस रणनीति
प्रत्येक आइटम वैश्विक नवीनीकरण विकल्पों को ओवरराइड कर सकता है
केवल UDID के लिए नवीनतम मिलान को अपडेट करें
match=first के साथ, केवल उसी UDID के तहत नवीनतम मैच किया गया प्रमाणपत्र अपडेट किया जाता है
त्रुटि कोड
122021X-Lang: enzh, en, zh-TW, vi, arकोड उदाहरण
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
}'नोट्स
- यह API केवल डिवाइस सदस्यता/प्रमाणपत्र डाउनलोड की समाप्ति तिथि अपडेट करता है। यह फिर से साइन या बैलेंस चार्ज नहीं करता।
- 0 का मतलब स्थायी होता है। एक्सटेंड मोड में, स्थायी डिवाइस डिफ़ॉल्ट रूप से स्थायी रहते हैं; सीमित समाप्ति को मजबूर करने के लिए base=now का उपयोग करें
- जब एक UDID कई प्रमाणपत्रों से मेल खाता है, match=all डिफ़ॉल्ट रूप से सभी को अपडेट करता है। व्यवहार बदलने के लिए first या error का उपयोग करें
- JSON और फॉर्म दोनों अनुरोध समर्थित हैं। फॉर्म आइटम JSON एरे स्ट्रिंग हो सकते हैं
कंसोल में आज़माएं
नीचे दिए गए पैरामीटर भरें और परीक्षण के लिए अनुरोध भेजें। अनुरोध केवल इस साइट के API पर ही जाता है; URL लॉक है और इसे बदला नहीं जा सकता, और आपका वर्तमान लॉगिन कुकी शामिल है।
https://testypro.iwai.cc/api/device/membership/renewइस साइट के लिए लॉक किया गया हैउपयोगकर्ता API टोकन
नवीनीकरण मोड: विस्तारित करें, सेट करें, या स्थायी। expire_time प्रदान किए जाने पर डिफ़ॉल्ट सेट होता है, अन्यथा विस्तारित करें
विस्तारित आधार: स्वचालित, वर्तमान, या अब
विस्तारित मोड में जोड़ने के लिए दिन
विस्तारित मोड में जोड़ने के लिए सेकंड। दिनों की तुलना में अधिक प्राथमिकता
अवधि अभिव्यक्ति: 30d, 12h, 60m, या 3600s
सेट मोड के लिए नया समाप्ति टाइमस्टैम्प, सेकंड या मिलीसेकंड में। 0 का मतलब स्थायी है
एकल डिवाइस KID
एकल डिवाइस UDID
डिवाइस KID एरे। कॉमा/स्पेस/न्यूलाइन से अलग किए गए स्ट्रिंग्स का भी समर्थन किया जाता है
डिवाइस UDID एरे। यदि एक UDID के पास कई प्रमाणपत्र हैं, तो match=all डिफ़ॉल्ट रूप से सभी को अपडेट करता है। कॉमा/स्पेस/न्यूलाइन से अलग किए गए स्ट्रिंग्स का भी समर्थन किया जाता है
उन्नत बैच आइटम। प्रत्येक आइटम में kid या UDID और override mode/base/days/seconds/duration/expire_time शामिल हो सकते हैं
कई मैच हैंडलिंग: all, first, या error। डिफ़ॉल्ट all
क्या किसी आइटम के फेल होने के बाद जारी रखना है। डिफ़ॉल्ट सत्य