API 对接文档
以下为示例模板,自己站点适配
1. IPA 贴牌打包
贴牌时在 /Payload/ZXSign.app/ 内一并处理:写入授权域名、修改应用名与 Bundle ID、替换贴牌图标、写入启动图,然后重签名打包。
| 操作时机 | IPA 解压 → 贴牌修改 → 重签名 → 打包 |
|---|---|
| config.plist | /Payload/ZXSign.app/config.plist · 写入 cert_api_base_url |
| Info.plist | /Payload/ZXSign.app/Info.plist · 修改应用名、Bundle ID |
| 贴牌图标 | 替换 AppIcon*.png / icon*.png,并写入 brand_icon*.png 等 |
| 启动图 | /Payload/ZXSign.app/UpdateBg.png |
| 授权域名 | https://csrjy.pkq7.cn(须带 https://你授权的域名哦别填我这个) |
config.plist 示例
授权域名记得带 https://,不要只写裸域名。
Info.plist 主要修改字段
说明
2. 贴牌时间锁(可选)
如需启用时间锁,在 /Payload/ZXSign.app/ 根目录写入 zsign.txt,并在使用 zsign 重签打包 IPA 时通过 -l 参数注入 zsign.dylib 插件。客户端运行时按 zsign.txt 中的地址请求时间锁接口校验设备状态。
| 是否必须 | 否,不需要时间锁可跳过 |
|---|---|
| zsign.txt | 写入 /Payload/ZXSign.app/zsign.txt |
| zsign.dylib | zsign 打包时用 -l 注入,非手动复制 |
| zsign.txt 内容 | 时间锁校验 URL,如 https://csrjy.pkq7.cn/api/sign/zxudid?udid=设备UDID |
| 校验接口 | GET https://csrjy.pkq7.cn/api/sign/zxudid |
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| udid | string | 是 | 设备 UDID |
| appbundileid | string | 否 | App Bundle ID,如 com.zx.sign(注意字段拼写) |
| daixiao | string | 否 | 代销站点标识,打包时写入 zsign.txt |
zsign.txt 示例
PHP 写入 zsign.txt和注入dylib例子
贴牌时间锁完整流程(可自行补充)
时间锁接口 · 请求示例 如何控制接口那是你站点的事情哦 自己想办法开启和关闭这个接口的返回值
正常响应(code=1)
设备禁用(code=0)
设备到期/掉签(code=0)
接口参数说明(可自行补充)
3. 获取配置
客户端启动时调用,根据 App Bundle ID 获取贴牌配置(图标、名称、源地址、公告等)。
| 接口地址 | 授权域名/api/signtool/index |
|---|---|
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded; charset=utf-8 |
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_bundle_id | string | 是 | App Bundle ID,如 com.zx.sign |
请求示例
成功响应示例
响应字段说明(可自行补充)
4. 获取可用证书
根据设备 UDID 查询该设备可用的描述文件与证书信息。
| 接口地址 | 授权域名/api/signtool/udid |
|---|---|
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded; charset=utf-8 |
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| udids[] | array | 是 | 设备 UDID 数组,如 00008120-0000000000000E |
请求示例(抓包原文)
cURL 调用示例
成功响应示例
响应字段说明
5. 获取证书文件
根据描述文件 ID 下载 mobileprovision 与 p12 证书(Base64 编码)。
| 接口地址 | 授权域名/api/signtool/getcertificate |
|---|---|
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded; charset=utf-8 |
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| profile_id | string | 是 | 描述文件 ID,来自「获取可用证书」接口的 profile_id,如 TW07TP |
请求示例(抓包原文)
成功响应示例
响应字段说明(可自行补充)
6. 获取企业证书
获取企业证书列表,返回 p12 / 描述文件下载地址及密码等信息。
| 接口地址 | 授权域名/api/cert/index |
|---|---|
| 请求方式 | GET |
成功响应示例
响应字段说明(可自行补充)