Perpanjang Keanggotaan Perangkat
Pembaruan massal masa berlaku keanggotaan perangkat dengan pencocokan fleksibel dan mode perpanjangan.
/api/device/membership/renewParameter Permintaan
Semua parameter dapat dikirim melalui Query atau Body
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
token | string | Wajib | Token API pengguna Contoh: your_api_token_here |
mode | string | Opsional | Mode perpanjangan: perpanjang, setel, atau permanen. Default adalah setel ketika expire_time diberikan, jika tidak perpanjang extendsetpermanent Contoh: extend |
base | string | Opsional | Perpanjang basis: otomatis, saat ini, atau sekarang autocurrentnow Contoh: auto |
days | number | Opsional | Hari yang akan ditambahkan dalam mode perpanjang Contoh: 30 |
seconds | number | Opsional | Detik yang akan ditambahkan dalam mode perpanjang. Prioritas lebih tinggi dari hari Contoh: 2592000 |
duration | string | Opsional | Ekspresi durasi: 30h, 12h, 60m, atau 3600s Contoh: 30d |
expire_time | number | Opsional | Timestamp kedaluwarsa baru untuk mode setel, detik atau milidetik. 0 berarti permanen Contoh: 1772267945 |
kid | string | Opsional | KID perangkat tunggal Contoh: KID001 |
udid | string | Opsional | UDID perangkat tunggal Contoh: 00008030-001234567890002E |
kids | array | Opsional | Array KID perangkat. String yang dipisahkan dengan koma/spasi/baris baru juga didukung Contoh: KID001,KID002 |
udids | array | Opsional | Array UDID perangkat. Jika satu UDID memiliki beberapa sertifikat, match=all akan memperbarui semuanya secara default. String yang dipisahkan dengan koma/spasi/baris baru juga didukung Contoh: 00008030-001234567890002E |
items | array | Opsional | Item batch lanjutan. Setiap item dapat mencakup kid atau UDID dan mengubah mode/base/hari/detik/durasi/waktu_kedaluwarsa Contoh: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}] |
match | string | Opsional | Penanganan beberapa kecocokan: all, first, atau error. Default all allfirsterror Contoh: all |
continue_on_error | boolean | Opsional | Apakah melanjutkan setelah satu item gagal. Default true Contoh: true |
Respon
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
code | number | Wajib | Kode status: 1=permintaan diproses Contoh: 1 |
data.total | number | Wajib | Jumlah item perangkat yang diminta Contoh: 2 |
data.success | number | Wajib | Jumlah perpanjangan berhasil Contoh: 2 |
data.failed | number | Wajib | Jumlah perpanjangan gagal Contoh: 0 |
data.results[].kid | string | Wajib | KID Perangkat Contoh: KID001 |
data.results[].old_expire_time | number | Wajib | Cap waktu kedaluwarsa keanggotaan sebelumnya. 0 berarti permanen Contoh: 1769675945 |
data.results[].new_expire_time | number | Wajib | Cap waktu kedaluwarsa keanggotaan baru. 0 berarti permanen Contoh: 1772267945 |
data.results[].new_expire_at | string | Wajib | Waktu kedaluwarsa baru yang diformat Contoh: 2026-02-28 15:04:05 |
Perpanjangan batch 30 hari berdasarkan KID
Gunakan KID yang dipisahkan koma dengan mode perpanjangan
Perpanjangan batch berdasarkan UDID
Untuk skenario di mana hanya UDID yang tersedia. Beberapa sertifikat di bawah satu UDID diperbarui secara default
Tetapkan waktu kedaluwarsa secara eksplisit
Gunakan mode=set untuk menetapkan stempel waktu kedaluwarsa keanggotaan secara eksplisit
Tetapkan permanen
Gunakan mode=permanent untuk membuat keanggotaan permanen
Strategi per-perangkat
Setiap item dapat menimpa opsi pembaruan global
Hanya perbarui kecocokan terbaru untuk satu UDID
Dengan match=first, hanya sertifikat terbaru yang cocok di bawah UDID yang sama yang diperbarui
Kode Kesalahan
122021X-Lang: enzh, en, zh-TW, vi, arContoh Kode
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
}'Catatan
- API ini hanya memperbarui keanggotaan perangkat/masa kedaluwarsa unduhan sertifikat. Ini tidak menandatangani ulang atau membebankan saldo
- 0 berarti permanen. Dalam mode perpanjangan, perangkat permanen tetap permanen secara default; gunakan base=now untuk memaksa masa berlaku terbatas
- Ketika sebuah UDID cocok dengan beberapa sertifikat, match=all memperbarui semuanya secara default. Gunakan first atau error untuk mengubah perilaku
- Baik permintaan JSON maupun form didukung. Item form bisa berupa string array JSON
Coba di Konsol
Isi parameter di bawah ini dan kirim permintaan untuk menguji. Permintaan hanya dikirim ke API situs ini; URL terkunci dan tidak dapat diubah, dan cookie login Anda saat ini disertakan.
https://testypro.iwai.cc/api/device/membership/renewTerkunci ke situs iniToken API pengguna
Mode perpanjangan: perpanjang, setel, atau permanen. Default adalah setel ketika expire_time diberikan, jika tidak perpanjang
Perpanjang basis: otomatis, saat ini, atau sekarang
Hari yang akan ditambahkan dalam mode perpanjang
Detik yang akan ditambahkan dalam mode perpanjang. Prioritas lebih tinggi dari hari
Ekspresi durasi: 30h, 12h, 60m, atau 3600s
Timestamp kedaluwarsa baru untuk mode setel, detik atau milidetik. 0 berarti permanen
KID perangkat tunggal
UDID perangkat tunggal
Array KID perangkat. String yang dipisahkan dengan koma/spasi/baris baru juga didukung
Array UDID perangkat. Jika satu UDID memiliki beberapa sertifikat, match=all akan memperbarui semuanya secara default. String yang dipisahkan dengan koma/spasi/baris baru juga didukung
Item batch lanjutan. Setiap item dapat mencakup kid atau UDID dan mengubah mode/base/hari/detik/durasi/waktu_kedaluwarsa
Penanganan beberapa kecocokan: all, first, atau error. Default all
Apakah melanjutkan setelah satu item gagal. Default true