ต่ออายุสมาชิกอุปกรณ์
อัปเดตการหมดอายุสมาชิกอุปกรณ์แบบเป็นชุดโดยมีการจับคู่และโหมดการต่ออายุที่ยืดหยุ่น
/api/device/membership/renewพารามิเตอร์คำขอ
พารามิเตอร์ทั้งหมดสามารถส่งผ่าน Query หรือ Body
| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
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 และแทนที่ 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 ตัวอย่าง: 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 |
ต่ออายุเป็นชุด 30 วันโดยใช้ KID
ใช้ KID คั่นด้วยจุลภาคพร้อมโหมดต่ออายุ
ต่ออายุเป็นชุดโดยใช้ UDID
สำหรับสถานการณ์ที่มีเพียง UDID เท่านั้น ใบรับรองหลายรายการภายใต้ UDID เดียวจะได้รับการอัปเดตตามค่าเริ่มต้น
ตั้งค่าเวลาหมดอายุอย่างชัดเจน
ใช้โหมด=set เพื่อตั้งเวลาหมดอายุสมาชิกอย่างชัดเจน
ตั้งค่าเป็นถาวร
ใช้โหมด=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 และแทนที่ mode/base/days/seconds/duration/expire_time
การจัดการการจับคู่หลายรายการ: all, first หรือ error ค่าเริ่มต้น all
ว่าจะดำเนินการต่อหลังจากที่รายการใดล้มเหลวหรือไม่ ค่าเริ่มต้นคือ true