适用场景iOS 开发者在打包、上架或做企业分发时经常需要处理 .p12 证书和 .mobileprovision 描述文件。手动解析这些文件需要打开 Keychain Access、查看证书信息、检查权限列表过程繁琐且容易出错。当自动化 CI/CD 流程需要验证证书有效性或描述文件是否匹配时手动操作完全不可行。该 API 解决的核心场景包括证书有效性校验自动检测证书是否已被 Apple 吊销输出剩余有效天数。描述文件与证书匹配检测判断证书是否已加入描述文件的白名单。权限审计提取描述文件中的 25 项 entitlements包括推送通知aps、调试debug、钥匙串keychain等。设备列表提取对于开发描述文件或 Ad Hoc 描述文件可解析绑定的设备 UDID 列表。CI/CD 集成在打包前自动验证证书和描述文件状态避免因证书过期或吊销导致构建失败。接口能力边界能做什么能力项说明证书基本信息名称、颁发者、序列号、有效期、是否吊销描述文件信息名称、有效期、证书类型Development / Distribution / Enterprise、Team ID、App ID设备列表适用于开发/Ad Hoc 描述文件返回授权设备 UDID权限列表提取 25 项常用 entitlement如 aps-environment、get-task-allow、keychain-access-groups 等匹配验证检查指定证书是否在描述文件的签名列表中不能做什么无法创建或签发证书、描述文件。无法修改 Apple Developer Center 的数据如撤销证书、添加设备。不支持 .cer 或 .pem 格式的直接解析需要先转换为 .p12。QPS 限制为 5 次/秒高频批量请求需做限速或排队。请求参数与鉴权API 采用 HTTP POST 方式需要两个必须参数和一个可选参数参数类型必填说明certstring是.p12 文件内容的 Base64 编码provisionstring是.mobileprovision 文件内容的 Base64 编码passwordstring否证书密码若 .p12 有密码鉴权方式通过请求头X-API-Key传入 API Key。在调用前需从用户后台获取有效的 API Key。curl 请求示例下面是一个完整的 curl 调用示例请将YOUR_API_KEY替换为实际密钥cert_base64和provision_base64替换为真实文件内容curl -sS -X POST \ -H X-API-Key: YOUR_API_KEY \ -H Content-Type: application/json \ -d { cert: MIIJ...base64..., provision: PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4K..., password: mycertpwd } \ https://v1.apizero.cn/api/ios-cert如果证书无密码可以省略password字段。响应字段解读成功响应示例JSON{ code: 0, msg: 成功, data: { certificate: { is_revoked: false, name: iPhone Developer: John Doe (ABCDE12345), status: 正常 }, mobileprovision: { cert_end_days: 350, cert_type: Development, team_id: ABCDE12345, app_id: com.example.app, devices: [00008030-..., 00008110-...], creation_date: 2024-03-01T00:00:00Z, expiration_date: 2025-03-01T00:00:00Z }, is_matching: true, permissions: { aps: true, debug: true, keychain: true, iCloud: false, push_to_talk: false, voip: false } } }关键字段说明code: 0 表示成功非 0 表示错误。data.certificate.is_revoked: 布尔值true 表示证书已被 Apple 吊销。data.certificate.status: 状态文本如“正常”、“已吊销”。data.mobileprovision.cert_end_days: 证书剩余有效天数整数。data.mobileprovision.cert_type: 证书类型常见值Development、Distribution、Enterprise。data.mobileprovision.devices: 授权设备 UDID 数组仅开发/Ad Hoc 有值。data.is_matching: 布尔值表示传入的证书是否在描述文件的签名列表中。data.permissions: 包含 25 项 entitlements 的布尔值映射。常见错误处理HTTP 状态码错误码说明排查建议4011001API Key 无效或缺失检查请求头X-API-Key是否正确4002001请求体缺少必填字段确保cert和provision均已提供4002002Base64 解码失败检查文件是否正常 Base64 编码没有多余换行4002003证书密码错误确认密码是否正确或尝试空密码4002004文件格式不支持确保提供的是 .p12 和 .mobileprovision5009000服务内部错误稍后重试或查看服务状态工程化注意事项Base64 编码处理在 Linux 或 macOS 中可用base64 -w0 file.p12生成长字符串。注意确保不含额外空格。文件大小与内存.p12 文件可能较大建议使用流式读取后编码避免一次性加载到内存。QPS 限制接口 QPS 为 5若需批量处理多个描述文件建议加入请求间隔或使用异步队列。证书密码安全避免将密码硬编码在代码或环境变量中可使用密钥管理服务。描述文件解析后存储可缓存返回的cert_end_days和expiration_date提前预警过期。错误重试策略对于 5xx 错误采用指数退避重试对于 4xx 错误先修正请求参数。参考文档iOS 证书与描述文件检测 API 文档原始文档 (Markdown)注意文档中可能包含更多字段说明和更新日志建议以最新线上版本为准。