Perbaharui Keahlian Peranti
Kemas kini berkelompok tamat keahlian peranti dengan padanan fleksibel dan mod pembaharuan.
/api/device/membership/renewParameter Permintaan
Semua parameter boleh dihantar melalui Kuiri atau Badan
| Parameter | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
token | string | Diperlukan | Token API pengguna Contoh: your_api_token_here |
mode | string | Pilihan | Mod perbaharui: sambung, tetapkan, atau kekal. Lalai kepada tetapkan apabila expire_time diberikan, jika tidak sambung extendsetpermanent Contoh: extend |
base | string | Pilihan | Sambung asas: auto, semasa, atau sekarang autocurrentnow Contoh: auto |
days | number | Pilihan | Bilangan hari untuk ditambah dalam mod sambung Contoh: 30 |
seconds | number | Pilihan | Bilangan saat untuk ditambah dalam mod sambung. Keutamaan lebih tinggi daripada hari Contoh: 2592000 |
duration | string | Pilihan | Ungkapan tempoh: 30h, 12j, 60m, atau 3600s Contoh: 30d |
expire_time | number | Pilihan | Cap masa tamat baru untuk mod tetapkan, saat atau milisaat. 0 bermaksud kekal Contoh: 1772267945 |
kid | string | Pilihan | KID satu peranti Contoh: KID001 |
udid | string | Pilihan | UDID satu peranti Contoh: 00008030-001234567890002E |
kids | array | Pilihan | Array KID peranti. Rentetan yang dipisahkan dengan koma/spasi/baris baru juga disokong Contoh: KID001,KID002 |
udids | array | Pilihan | Array UDID peranti. Jika satu UDID mempunyai pelbagai sijil, match=all mengemas kini semua secara lalai. Rentetan yang dipisahkan dengan koma/spasi/baris baru juga disokong Contoh: 00008030-001234567890002E |
items | array | Pilihan | Item batch lanjutan. Setiap item boleh termasuk kid atau UDID dan ganti mod/asas/hari/saat/tempoh/waktu tamat Contoh: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}] |
match | string | Pilihan | Pengendalian padanan berganda: semua, pertama, atau ralat. Lalai semua allfirsterror Contoh: all |
continue_on_error | boolean | Pilihan | Sama ada untuk meneruskan selepas satu item gagal. Lalai benar Contoh: true |
Respons
| Parameter | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
code | number | Diperlukan | Kod status: 1=permintaan diproses Contoh: 1 |
data.total | number | Diperlukan | Bilangan item peranti yang diminta Contoh: 2 |
data.success | number | Diperlukan | Bilangan pembaharuan berjaya Contoh: 2 |
data.failed | number | Diperlukan | Bilangan pembaharuan gagal Contoh: 0 |
data.results[].kid | string | Diperlukan | KID Peranti Contoh: KID001 |
data.results[].old_expire_time | number | Diperlukan | Cap masa tamat keahlian sebelumnya. 0 bermaksud kekal Contoh: 1769675945 |
data.results[].new_expire_time | number | Diperlukan | Cap masa tamat keahlian baru. 0 bermaksud kekal Contoh: 1772267945 |
data.results[].new_expire_at | string | Diperlukan | Masa tamat baru yang diformat Contoh: 2026-02-28 15:04:05 |
Sambungan secara pukal 30 hari oleh KID
Gunakan KID yang dipisahkan oleh koma dengan mod sambungan
Sambungan secara pukal mengikut UDID
Untuk senario di mana hanya UDID yang tersedia. Pelbagai sijil di bawah satu UDID dikemas kini secara lalai
Tetapkan masa tamat sah yang jelas
Gunakan mod=set untuk menetapkan cap masa tamat keahlian yang jelas
Tetapkan kekal
Gunakan mod=permanent untuk menjadikan keahlian kekal
Strategi per peranti
Setiap item boleh mengatasi pilihan pembaharuan global
Hanya kemas kini padanan terbaru untuk satu UDID
Dengan match=first, hanya sijil yang sepadan terbaru di bawah UDID yang sama dikemas kini
Kod Ralat
122021X-Lang: enzh, en, zh-TW, vi, arContoh Kod
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
}'Nota
- API ini hanya mengemas kini keahlian peranti/tempoh muat turun sijil. Ia tidak menandatangani semula atau menukar baki
- 0 bermaksud kekal. Dalam mod sambungan, peranti kekal adalah kekal secara lalai; gunakan base=now untuk memaksa tamat tempoh terhad
- Apabila UDID sepadan dengan pelbagai sijil, match=all mengemas kini semua secara lalai. Gunakan first atau error untuk mengubah tingkah laku
- Kedua-dua permintaan JSON dan borang disokong. Item borang boleh menjadi string tatasusunan JSON
Cuba di Konsol
Isikan parameter di bawah dan hantar permintaan untuk menguji. Permintaan hanya dihantar ke API laman ini; URL dikunci dan tidak boleh diubah, dan kuki log masuk semasa anda disertakan.
https://testypro.iwai.cc/api/device/membership/renewDikunci ke laman iniToken API pengguna
Mod perbaharui: sambung, tetapkan, atau kekal. Lalai kepada tetapkan apabila expire_time diberikan, jika tidak sambung
Sambung asas: auto, semasa, atau sekarang
Bilangan hari untuk ditambah dalam mod sambung
Bilangan saat untuk ditambah dalam mod sambung. Keutamaan lebih tinggi daripada hari
Ungkapan tempoh: 30h, 12j, 60m, atau 3600s
Cap masa tamat baru untuk mod tetapkan, saat atau milisaat. 0 bermaksud kekal
KID satu peranti
UDID satu peranti
Array KID peranti. Rentetan yang dipisahkan dengan koma/spasi/baris baru juga disokong
Array UDID peranti. Jika satu UDID mempunyai pelbagai sijil, match=all mengemas kini semua secara lalai. Rentetan yang dipisahkan dengan koma/spasi/baris baru juga disokong
Item batch lanjutan. Setiap item boleh termasuk kid atau UDID dan ganti mod/asas/hari/saat/tempoh/waktu tamat
Pengendalian padanan berganda: semua, pertama, atau ralat. Lalai semua
Sama ada untuk meneruskan selepas satu item gagal. Lalai benar