登录 – XySign
API 接口文档
返回
DEVELOPER CENTER

API 接口文档

把证书站能力接入你的业务。这里整理了鉴权方式、请求格式与常用接口示例。

查看接口说明 API v1.0 HTTPS
统一使用 HTTPS + POST 表单请求,Token 放在请求体中。申请接口会产生真实业务操作;超时后请先查询记录,再决定是否重试。
POST

秒出 / 立即申请证书

/api/adddevice

提交后立即尝试创建证书。是否成功及费用取决于账户、套餐、库存和站点配置。

请求参数
参数类型必填说明
tokenstring必填用户中心的证书对接密钥,用于识别账户。
udidstring必填设备 UDID;控制器接受 25 位或 40 位格式。
typeinteger选填证书池:0 公共池、1 独立池、2 独立池优先并回退公共池;默认按代码处理为 0。
warrantyinteger选填套餐编号:0 躺平、1 标准、2 加强、3 稳定、4 摆烂、5/6 高摆;是否可用以账户和站点配置为准。
deviceTypestring选填设备类型:iphone、ipad 或 mac;默认 iphone。
beizhustring选填申请备注。
apple_idstring选填指定 Apple ID;仅在对应独立池场景生效。
resigninteger选填补签场景传 1;普通申请不要传。
resign_kidstring选填补签来源证书记录 ID;与 resign=1 配合使用。
响应参数
字段类型说明
codeinteger1 表示成功;失败或处理中可能返回 0、1001、1002、1003 等,需同时检查 msg。
msgstring本次请求结果说明,例如“添加成功”或错误原因。
timeinteger响应时间,Unix 时间戳;部分直接返回的分支可能不带此字段。
data.idstring证书记录 ID,可用于后续查询。
data.pnamestring证书名称。
data.poolinteger证书池标记:0 公共池、1 独立池。
data.addtimeinteger记录时间,Unix 时间戳。
data.mobileprovisionstring描述文件 Base64;尚未生成时可能为空字符串。
data.p12stringP12 证书 Base64。属于敏感凭证,请妥善保管。
data.errorstring部分失败响应会携带的错误原因。
data.sitesstring部分失败响应会标明失败来源或证书池。
请求示例
cURL
curl -X POST 'https://你的站点域名/api/adddevice' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'token=替换为用户自己的API_TOKEN' \
  --data-urlencode 'udid=替换为设备UDID' \
  --data-urlencode 'type=0' \
  --data-urlencode 'warranty=1' \
  --data-urlencode 'deviceType=iphone'
响应示例注释为字段说明,非严格 JSON
成功示例
{
  "code": 1, // 成功标志
  "msg": "添加成功", // 处理结果
  "time": 1792100000, // Unix 时间戳(秒)
  "data": {
    "id": "9526IS", // 证书记录 ID
    "pname": "Anthonie E Smith", // 证书名称
    "pool": 0, // 证书池:0 公共池,1 独立池
    "addtime": 1792100000, // 添加时间
    "mobileprovision": "Base64描述文件", // 描述文件内容
    "p12": "Base64P12文件" // P12 证书内容
  }
}
首页 证书 应用 分销 商城 软件源 钱包 我的