Back to HomeAPI Docs
Language: English
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
Back to Docs
GETPOST
v1.0.0stable

Update Device Remark

Update a device remark using token authentication

GET | POST/api/device/remark
Auth:API Key
Limit:60/minute

Request Parameters

All parameters can be passed via Query or Body

ParameterTypeRequiredDescription
token
stringRequired
User API token
Example: your_api_token_here
kid
stringOptional
Device KID. Provide either kid or udid
Example: ABC123XYZ
udid
stringOptional
Device UDID. Provide either kid or udid
Example: 00008030-001234567890002E
remark
stringRequired
New remark content (pass empty string to clear)
Example: 我的iPhone设备

Response

ParameterTypeRequiredDescription
code
numberRequired
Status code: 1=success, others=failure
Example: 1
msg
stringRequired
Response message
Example: 备注修改成功
time
numberRequired
Server timestamp (Unix seconds)
Example: 1769675945
data
objectRequired
Response payload
data.id
numberRequired
Device ID
Example: 12345
data.kid
stringRequired
Device KID
Example: ABC123XYZ
data.udid
stringRequired
Device UDID
Example: 00008030-001234567890002E
data.remark
stringRequired
Updated remark
Example: 我的iPhone设备
ip
stringRequired
Requester IP address
Example: 192.168.1.100
ysucc
stringRequired
Success flag, returns "Ysucc" on success
Example: Ysucc
Response Example
{
"code":1,
"msg":"Remark updated successfully",
"time":1769675945,
"data":
{
"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"remark":"我的iPhone设备"
}
,
"ip":"192.168.1.100",
"ysucc":"Ysucc"
}

Error Codes

Error Codes5 defined
12
Token is required
Token parameter is missing
10
Invalid token
Invalid or expired token
20
Please provide kid or udid
Missing kid or udid

Response Language

Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.

Recommended Header
X-Lang: en
Supported Languages
zh, en, zh-TW, vi, ar

Accept-Language is also supported; X-Lang takes priority. Unsupported languages fall back to English.

Code Examples

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

Notes

  • When multiple certificates exist for one udid, use kid to specify
  • Can only modify your own devices

Try it in Console

Fill in the parameters below and send a request to test. Requests only go to this site's API; the URL is locked and cannot be changed, and your current login cookie is included.

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%87Locked to this site
stringRequired

User API token

string

Device KID. Provide either kid or udid

string

Device UDID. Provide either kid or udid

stringRequired

New remark content (pass empty string to clear)