GETPOST

v1.0.0stable

获取证书

通过 Token 和证书 ID 或 UDID 获取证书，通过 UDID 查询时支持智能选择最佳证书

GET | POST/api/getcertificate

认证:API Key

限流:120/分钟

请求参数

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

参数名	类型	必填	说明
`token`	string	必填	用户 API Token 示例: your_api_token_here
`id`	string	可选	证书 ID，与 udid 二选一，同时提供时优先使用 id 示例: AB12CD34
`udid`	string	可选	设备 UDID，与 id 二选一，通过 UDID 查询时会智能选择最佳证书示例: 00008020-001A2B3C4D5E6F78

响应参数

参数名	类型	必填	说明
`code`	number	必填	状态码：1=成功，0=失败，2=无可用证书，3=证书已到期示例: 1
`msg`	string	必填	返回信息示例: 返回成功
`time`	number	必填	服务器时间戳（Unix 秒）示例: 1769675945
`data`	object	必填	业务数据
`data.id`	string	必填	证书 ID 示例: AB12CD34
`data.pname`	string	必填	项目名称示例: MyApp
`data.addtime`	number	必填	添加时间（Unix 时间戳）示例: 1706500000
`data.pool`	number	必填	池标识：0=公共池，1=独立池示例: 0
`data.type`	number	必填	池类型：0=公共池，1=独立池示例: 0
`data.mobileprovision`	string	必填	Base64 编码的 mobileprovision 示例: MIIPhgYJKoZIhvcNAQcCoII...(Base64)
`data.p12`	string	必填	Base64 编码的 P12 证书示例: MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)
`data.state`	boolean	必填	证书有效状态：true=有效，false=已掉签示例: true
`data.warranty`	boolean	必填	是否有售后保障示例: true
`data.warranty_time`	number	必填	售后到期时间（Unix 时间戳）示例: 1738000000
`data.shtype`	number	必填	售后类型：0=躺平版，1=标准版，2=加强版，3=稳定版，4=摆烂版，6=高摆烂版示例: 1
`ysucc`	string	必填	成功标识，成功时返回 "Ysucc" 示例: Ysucc

响应示例

{

"code":1,

"msg":"返回成功",

"time":1769675945,

"data":

{

"id":"AB12CD34",

"pname":"MyApp",

"addtime":1706500000,

"pool":0,

"type":0,

"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",

"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)",

"state":true,

"warranty":true,

"warranty_time":1738000000,

"shtype":1

}

"ysucc":"Ysucc"

}

错误码

错误码7 个定义

0

token验证失败

Token 无效或已过期

0

证书ID或UDID至少需要一个不为空

必须提供 id 或 udid 参数

0

证书ID不存在

指定的证书 ID 不存在或不属于当前用户

响应语言

通过 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/getcertificate?token=your_api_token_here&id=AB12CD34&udid=00008020-001A2B3C4D5E6F78" \
  -H "X-Lang: zh"

注意事项

支持 GET 和 POST 请求
参数通过 Query 或 x-www-form-urlencoded 传递
id 和 udid 二选一，同时提供时优先使用 id
通过 UDID 查询时智能选择最佳证书：优先返回正常状态，其次返回掉签但未禁用的证书
state=false 表示证书已掉签，但仍可下载使用（可能无法安装应用）
warranty_time 为售后到期时间，到期后如掉签需要重新买

在控制台试一试

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

https://testypro.iwai.cc/api/getcertificate?token=your_api_token_here&id=AB12CD34&udid=00008020-001A2B3C4D5E6F78已锁定本站

tokenstring必填

用户 API Token

idstring

证书 ID，与 udid 二选一，同时提供时优先使用 id

udidstring