GETPOST

v1.0.0stable

修改设备备注

使用 Token 鉴权更新设备备注

GET | POST/api/device/remark

认证:API Key

限流:60/分钟

请求参数

所有请求参数需通过 Query 或 Body 传递

参数名	类型	必填	说明
`token`	string	必填	用户 API Token 示例: your_api_token_here
`kid`	string	可选	设备 KID，与 udid 二选一示例: ABC123XYZ
`udid`	string	可选	设备 UDID，与 kid 二选一示例: 00008030-001234567890002E
`remark`	string	必填	新的备注内容（可传空字符串清空备注）示例: 我的iPhone设备

响应参数

参数名	类型	必填	说明
`code`	number	必填	状态码：1=成功，其他=失败示例: 1
`msg`	string	必填	返回信息示例: 备注修改成功
`time`	number	必填	服务器时间戳（Unix 秒）示例: 1769675945
`data`	object	必填	业务数据
`data.id`	number	必填	设备 ID 示例: 12345
`data.kid`	string	必填	设备 KID 示例: ABC123XYZ
`data.udid`	string	必填	设备 UDID 示例: 00008030-001234567890002E
`data.remark`	string	必填	更新后的备注示例: 我的iPhone设备
`ip`	string	必填	请求者 IP 地址示例: 192.168.1.100
`ysucc`	string	必填	成功标识，成功时返回 "Ysucc" 示例: Ysucc

响应示例

{

"code":1,

"msg":"备注修改成功",

"time":1769675945,

"data":

{

"id":12345,

"kid":"ABC123XYZ",

"udid":"00008030-001234567890002E",

"remark":"我的iPhone设备"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

错误码

错误码5 个定义

12

Token 不能为空

未提供 Token 参数

10

Token 无效

Token 不正确或已过期

20

请提供 kid 或 udid

未提供 kid 或 udid

响应语言

通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。

推荐请求头

X-Lang: zh

支持的语言

zh, en, zh-TW, vi, ar

也可以使用 Accept-Language；X-Lang 优先级更高。不支持的语言将回退为英文。

代码示例

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: zh"

注意事项

当一个 udid 有多个证书时，需要使用 kid 精确指定
只能修改属于自己的设备

在控制台试一试

填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态

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

已锁定本站

tokenstring必填

用户 API Token

kidstring

设备 KID，与 udid 二选一

udidstring

设备 UDID，与 kid 二选一

remarkstring必填