GETPOST

v1.0.0stable

Cập nhật ghi chú thiết bị

Cập nhật ghi chú thiết bị bằng xác thực token

GET | POST/api/device/remark

Xác thực:API Key

Giới hạn:60/phút

Tham 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	Token API người dùng Ví dụ: your_api_token_here
`kid`	string	Tùy chọn	KID thiết bị. Cung cấp kid hoặc udid Ví dụ: ABC123XYZ
`udid`	string	Tùy chọn	UDID thiết bị. Cung cấp kid hoặc udid Ví dụ: 00008030-001234567890002E
`remark`	string	Bắt buộc	Nội dung ghi chú mới (truyền chuỗi rỗng để xóa) Ví dụ: 我的iPhone设备

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=thành công, khác=thất bại Ví dụ: 1
`msg`	string	Bắt buộc	Tin nhắn phản hồi Ví dụ: 备注修改成功
`time`	number	Bắt buộc	Dấu thời gian máy chủ (giây Unix) Ví dụ: 1769675945
`data`	object	Bắt buộc	Dữ liệu phản hồi
`data.id`	number	Bắt buộc	ID thiết bị Ví dụ: 12345
`data.kid`	string	Bắt buộc	KID thiết bị Ví dụ: ABC123XYZ
`data.udid`	string	Bắt buộc	UDID thiết bị Ví dụ: 00008030-001234567890002E
`data.remark`	string	Bắt buộc	Ghi chú đã cập nhật Ví dụ: 我的iPhone设备
`ip`	string	Bắt buộc	Địa chỉ IP người yêu cầu Ví dụ: 192.168.1.100
`ysucc`	string	Bắt buộc	Cờ thành công, trả về "Ysucc" khi thành công Ví dụ: Ysucc

Ví dụ phản hồi

{

"code":1,

"msg":"Cập nhật ghi chú thành công",

"time":1769675945,

"data":

{

"id":12345,

"kid":"ABC123XYZ",

"udid":"00008030-001234567890002E",

"remark":"我的iPhone设备"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Mã lỗi

Mã lỗi5 được định nghĩa

12

Token không được để trống

Thiếu tham số Token

10

Token không hợp lệ

Token không hợp lệ hoặc đã hết hạn

20

Vui lòng cung cấp kid hoặc udid

Thiếu kid hoặc udid

Ngô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.

Header đề xuất

X-Lang: vi

Ngôn ngữ được hỗ trợ

zh, en, zh-TW, vi, ar

Bạ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 GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/remark?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&remark=%E6%88%91%E7%9A%84iPhone%E8%AE%BE%E5%A4%87" \
  -H "X-Lang: vi"

Lưu ý

Khi có nhiều chứng chỉ cho một udid, dùng kid để chỉ định
Chỉ có thể sửa đổi thiết bị của bạn

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/remark?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&remark=%E6%88%91%E7%9A%84iPhone%E8%AE%BE%E5%A4%87

Đã khóa vào trang này

tokenstringBắt buộc

Token API người dùng

kidstring

KID thiết bị. Cung cấp kid hoặc udid

udidstring

UDID thiết bị. Cung cấp kid hoặc udid

remarkstringBắt buộc

Nội dung ghi chú mới (truyền chuỗi rỗng để xóa)