Thêm thiết bị hàng loạt
Đăng ký nhiều UDID theo lô, hỗ trợ mặc định toàn cục và ghi đè từng mục. Mỗi thiết bị có thể dùng chế độ tức thì hoặc đặt trước.
/api/adddevice/batchTham 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 | Tùy chọn | Token API toàn cục. Dùng khi item/defaults không cung cấp token Ví dụ: your_api_token_here |
mode | string | Tùy chọn | Chế độ thêm toàn cục: instant hoặc review. Mặc định instant, có thể ghi đè instantreview Ví dụ: instant |
defaults | object | Tùy chọn | Tham số mặc định cho tất cả mục, ví dụ warranty/shtype/type/deviceType/beizhu/code/token/mode Ví dụ: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"} |
items | array | Tùy chọn | Mảng thiết bị. Mỗi mục cần udid và có thể ghi đè bất kỳ trường mặc định nào Ví dụ: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}] |
udids | array | Tùy chọn | Mảng UDID đơn giản, dùng tham số mặc định/toàn cục Ví dụ: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"] |
udids_text | string | Tùy chọn | Danh sách UDID dạng văn bản, phân tách bằng dấu phẩy, dấu chấm phẩy, khoảng trắng hoặc xuống dòng Ví dụ: 00008030-001234567890ABCD
00008020-00ABCDEF12345678 |
continue_on_error | boolean | Tùy chọn | Có tiếp tục sau khi một mục 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: 1=đã xử lý batch Ví dụ: 1 |
data.total | number | Bắt buộc | Tổng số thiết bị yêu cầu Ví dụ: 2 |
data.processed | number | Bắt buộc | Số mục đã xử lý Ví dụ: 2 |
data.success | number | Bắt buộc | Số lượng thành công Ví dụ: 1 |
data.failed | number | Bắt buộc | Số lượng thất bại Ví dụ: 1 |
data.results | array | Bắt buộc | Kết quả từng mục Ví dụ: |
Mã lỗi
000Ngô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/adddevice/batch" \
-H "X-Lang: vi" \
-H "Content-Type: application/json" \
-d '{
"token": "your_api_token_here",
"mode": "instant",
"defaults": "{\"warranty\":\"1\",\"type\":\"0\",\"deviceType\":\"iphone\",\"beizhu\":\"batch\"}",
"items": "[{\"udid\":\"00008030-001234567890ABCD\"},{\"udid\":\"00008020-00ABCDEF12345678\",\"mode\":\"review\",\"warranty\":\"2\",\"beizhu\":\"VIP device\"}]",
"udids": "[\"00008030-001234567890ABCD\",\"00008020-00ABCDEF12345678\"]",
"udids_text": "00008030-001234567890ABCD\n00008020-00ABCDEF12345678",
"continue_on_error": true
}'Lưu ý
- API này tái sử dụng logic /api/adddevice và /api/addyydevice, xử lý từng mục
- Body phải là JSON, tham số từng mục được chuyển thành form nội bộ
- defaults là tham số chung, item có độ ưu tiên cao hơn
- mode hỗ trợ instant/review
- Tối đa 50 mục mỗi request, giới hạn 10 request/phút
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/adddevice/batchĐã khóa vào trang nàyToken API toàn cục. Dùng khi item/defaults không cung cấp token
Chế độ thêm toàn cục: instant hoặc review. Mặc định instant, có thể ghi đè
Tham số mặc định cho tất cả mục, ví dụ warranty/shtype/type/deviceType/beizhu/code/token/mode
Mảng thiết bị. Mỗi mục cần udid và có thể ghi đè bất kỳ trường mặc định nào
Mảng UDID đơn giản, dùng tham số mặc định/toàn cục
Danh sách UDID dạng văn bản, phân tách bằng dấu phẩy, dấu chấm phẩy, khoảng trắng hoặc xuống dòng
Có tiếp tục sau khi một mục lỗi không. Mặc định true