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-TW

支援的語言

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-TW"

注意事項

當一個 udid 有多個證書時，需要使用 kid 精確指定
只能修改屬於自己的設備

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

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必填

新的備註內容（可傳空字符串清空備註）