Gia hạn thành viên thiết bị
Cập nhật hạn thành viên thiết bị hàng loạt với nhiều cách khớp và chế độ gia hạn.
/api/device/membership/renewTham số yêu cầu
Tất cả tham số có thể truyền qua Query hoặc Body
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
token | string | Bắt buộc | API Token người dùng Ví dụ: your_api_token_here |
mode | string | Tùy chọn | Chế độ gia hạn: extend, set hoặc permanent extendsetpermanent Ví dụ: extend |
base | string | Tùy chọn | Mốc gia hạn: auto, current hoặc now autocurrentnow Ví dụ: auto |
days | number | Tùy chọn | Số ngày gia hạn Ví dụ: 30 |
seconds | number | Tùy chọn | Số giây gia hạn, ưu tiên hơn days Ví dụ: 2592000 |
duration | string | Tùy chọn | Biểu thức thời lượng: 30d, 12h, 60m hoặc 3600s Ví dụ: 30d |
expire_time | number | Tùy chọn | Timestamp hết hạn mới cho chế độ set, giây hoặc mili giây. 0 là vĩnh viễn Ví dụ: 1772267945 |
kid | string | Tùy chọn | KID của một thiết bị Ví dụ: KID001 |
udid | string | Tùy chọn | UDID của một thiết bị Ví dụ: 00008030-001234567890002E |
kids | array | Tùy chọn | Danh sách KID thiết bị Ví dụ: KID001,KID002 |
udids | array | Tùy chọn | Danh sách UDID thiết bị Ví dụ: 00008030-001234567890002E |
items | array | Tùy chọn | Danh sách nâng cao, mỗi thiết bị có thể có cấu hình riêng Ví dụ: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}] |
match | string | Tùy chọn | Xử lý nhiều kết quả: all, first hoặc error allfirsterror Ví dụ: all |
continue_on_error | boolean | Tùy chọn | Có tiếp tục khi một thiết bị lỗi không, mặc định true Ví dụ: true |
Phản hồi
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
code | number | Bắt buộc | Mã trạng thái Ví dụ: 1 |
data.total | number | Bắt buộc | Số thiết bị yêu cầu Ví dụ: 2 |
data.success | number | Bắt buộc | Số lượng gia hạn thành công Ví dụ: 2 |
data.failed | number | Bắt buộc | Số lượng gia hạn thất bại Ví dụ: 0 |
data.results[].kid | string | Bắt buộc | KID thiết bị Ví dụ: KID001 |
data.results[].old_expire_time | number | Bắt buộc | Timestamp hết hạn trước đó Ví dụ: 1769675945 |
data.results[].new_expire_time | number | Bắt buộc | Timestamp hết hạn mới Ví dụ: 1772267945 |
data.results[].new_expire_at | string | Bắt buộc | Thời gian hết hạn mới đã định dạng Ví dụ: 2026-02-28 15:04:05 |
Gia hạn 30 ngày bằng KID
Dùng kids phân tách bằng dấu phẩy
Gia hạn hàng loạt bằng UDID
Phù hợp khi chỉ có UDID
Đặt thời gian hết hạn cụ thể
Dùng mode=set để đặt timestamp hết hạn cụ thể
Đặt vĩnh viễn
Dùng mode=permanent để đặt vĩnh viễn
Chiến lược riêng từng thiết bị
Mỗi item có thể ghi đè tùy chọn chung
Chỉ cập nhật bản mới nhất cho UDID
Với match=first chỉ cập nhật chứng chỉ mới nhất
Mã lỗi
122021Ngôn ngữ phản hồi
Tùy chỉnh ngôn ngữ phản hồi API bằng header X-Lang. Ví dụ mã bên dưới tự động sử dụng ngôn ngữ trang hiện tại của bạn.
X-Lang: vizh, en, zh-TW, vi, arBạn cũng có thể dùng Accept-Language; X-Lang có ưu tiên cao hơn. Ngôn ngữ không được hỗ trợ sẽ chuyển sang tiếng Anh.
Ví dụ mã
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/membership/renew" \
-H "X-Lang: vi" \
-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
}'Lưu ý
- API này chỉ cập nhật hạn thành viên/quyền tải chứng chỉ của thiết bị, không ký lại và không trừ tiền
- 0 nghĩa là vĩnh viễn. Ở chế độ extend, thiết bị vĩnh viễn vẫn giữ vĩnh viễn mặc định
- Khi UDID khớp nhiều chứng chỉ, match=all cập nhật tất cả theo mặc định
- Hỗ trợ JSON và form; form items có thể là chuỗi JSON array
Thử trong Console
Điền các tham số bên dưới rồi gửi yêu cầu để kiểm tra. Yêu cầu chỉ gửi đến API của trang này; địa chỉ đã bị khóa và không thể thay đổi, đồng thời kèm theo Cookie đăng nhập hiện tại của bạn.
https://testypro.iwai.cc/api/device/membership/renewĐã khóa vào trang nàyAPI Token người dùng
Chế độ gia hạn: extend, set hoặc permanent
Mốc gia hạn: auto, current hoặc now
Số ngày gia hạn
Số giây gia hạn, ưu tiên hơn days
Biểu thức thời lượng: 30d, 12h, 60m hoặc 3600s
Timestamp hết hạn mới cho chế độ set, giây hoặc mili giây. 0 là vĩnh viễn
KID của một thiết bị
UDID của một thiết bị
Danh sách KID thiết bị
Danh sách UDID thiết bị
Danh sách nâng cao, mỗi thiết bị có thể có cấu hình riêng
Xử lý nhiều kết quả: all, first hoặc error
Có tiếp tục khi một thiết bị lỗi không, mặc định true