DeviceCheck Server API

POST /api/generate_token

输入 appID, 生成 DeviceCheck token

参数	类型	必填	说明
appid	string	是	App ID, 格式: TEAMID.com.bundle.id
device	string	否	指定设备证书名, 不填用默认

curl -X POST /api/generate_token \
  -H "Content-Type: application/json" \
  -d '{"appid":"CDGL4ZP6KD.com.immomo.DeviceCheckDemo1"}'

响应:

{"token":"AgAAA...(base64)","appid":"...","length":2310}

POST /api/generate_and_query

生成 token 并立即调 Apple API 查询两个 bit

参数	类型	必填	说明
appid	string	是	App ID
device	string	否	指定设备证书名

curl -X POST /api/generate_and_query \
  -H "Content-Type: application/json" \
  -d '{"appid":"CDGL4ZP6KD.com.immomo.DeviceCheckDemo1"}'

响应:

{"appid":"...","apple_result":{"bit0":true,"bit1":false,"last_update_time":"2026-06"}}

POST /api/bind

客户端上报 UDID, 自动分配一个证书并绑定 (同一 UDID 始终绑定同一证书)

参数	类型	必填	说明
udid	string	是	设备 UDID

curl -X POST /api/bind \
  -H "Content-Type: application/json" \
  -d '{"udid":"00008101-001641360E46001E"}'

响应:

{"udid":"00008101-...","device":"default","status":"bound"}

POST /api/token_by_udid

传 UDID + appID, 用绑定的证书生成 token

参数	类型	必填	说明
udid	string	是	设备 UDID
appid	string	否	App ID, 不填用默认

curl -X POST /api/token_by_udid \
  -H "Content-Type: application/json" \
  -d '{"udid":"00008101-...","appid":"CDGL4ZP6KD.com.immomo.DeviceCheckDemo1"}'

响应:

{"token":"AgAAA...","udid":"...","device":"default","appid":"..."}

POST /api/query_by_udid

传 UDID + appID, 生成 token 并查 Apple

参数	类型	必填	说明
udid	string	是	设备 UDID
appid	string	否	App ID

curl -X POST /api/query_by_udid \
  -H "Content-Type: application/json" \
  -d '{"udid":"00008101-...","appid":"CDGL4ZP6KD.com.immomo.DeviceCheckDemo1"}'

响应:

{"udid":"...","device":"default","appid":"...","apple_result":{"bit0":true,"bit1":false,"last_update_time":"2026-06"}}

POST /api/unbind

解除 UDID 绑定, 释放证书

参数	类型	必填	说明
udid	string	是	设备 UDID

curl -X POST /api/unbind \
  -H "Content-Type: application/json" \
  -d '{"udid":"00008101-..."}'

GET /api/bindings

查看所有 UDID ↔ 证书绑定关系

curl /api/bindings

响应:

{"bindings":{"udid1":"default","udid2":"iphone4"},"total_certs":2,"bound":2,"available":0}

POST /api/offline_query

用默认/指定设备生成 token 查 Apple

参数	类型	必填	说明
device	string	否	设备名

POST /api/offline_update

生成 token 并设置 bit 值

参数	类型	必填	说明
bit0	bool	否	default false
bit1	bool	否	default false
device	string	否	设备名

POST /api/offline_batch

批量生成 token 并查询

参数	类型	必填	说明
count	int	否	数量, 默认 5, 最大 50
device	string	否	设备名

GET /api/devices

列出所有已添加的设备证书名

GET /api/get_device?name=xxx

获取设备详情

POST /api/save_device

添加/更新设备证书

参数	类型	必填	说明
name	string	是	设备名
cert	string	是	证书链 base64
appid	string	否	默认 appID

POST /api/delete_device

删除设备证书

参数	类型	必填	说明
name	string	是	设备名

POST /api/query

用客户端传来的 token 查 Apple

参数	类型	必填	说明
device_token	string	是	base64 token

POST /api/update

用客户端传来的 token 设置 bit

参数	类型	必填	说明
device_token	string	是	base64 token
bit0	bool	否
bit1	bool	否

GET /api/logs

获取最近 50 条操作日志