适用场景与能力边界iOS 证书与描述文件检测接口slug: ios-cert用于解析 .p12 证书和 .mobileprovision 描述文件。在一次请求内完成多维度校验证书有效期、吊销状态、Team ID、证书类型开发/分发/企业、设备列表、entitlements 权限清单同时验证证书与描述文件是否匹配。对于需要构建证书巡检、CI/CD 签名校验、内部证书管理工具的开发团队这个接口可作为核心检测模块。在使用前需要明确其能力边界。接口按单次请求处理一份证书与一份描述文件不支持批量文件上传也没有计划任务接口。更关键的是接口的 QPS 限制为 5/s即每秒最多处理 5 个请求。这个限制决定了它不适合对大量证书进行高并发扫描。例如在短时间内校验 100 份证书如果直接用循环并发请求会很快触发限流。因此接入方必须在客户端做好频率控制和任务排队。调用限制与用量边界QPS 5/s 是一个相对严格的频率约束。从工程角度看这意味着单次请求的平均间隔应大于等于 200ms。无法通过多线程/并发来提高单位时间内的处理量。若需要批量检测只能将任务串行化或分散到多个时间窗口。接口未提供内建的重试机制401/429 等响应需要调用方自行处理。这里需要区分“QPS 限制”与“总调用量限制”。文档页并未说明月度或日调用总量因此建议以文档页的官方说明为准。在接入时建议将从接口获取的证书信息做缓存例如将is_revoked、cert_end_days等结果保存到本地数据库设置合理的缓存过期时间从而减少不必要的重复请求。鉴权与请求头接口文档列出的两个 Header 参数Authorization必填stringContent-Type必填string对应 application/json需要留意官方 curl 示例中使用了X-API-Key请求头传递 API Key。两种鉴权方式可能在不同版本中存在差异具体以文档页为准。无论使用哪种方式调用前都应确认密钥有效并避免在客户端代码中硬编码密钥。请求体参数接口采用 POST 方法地址为https://v1.apizero.cn/api/ios-cert。请求体是一个 JSON 对象包含三个字段字段类型必填说明certstring是Base64 编码的 .p12 文件内容provisionstring是Base64 编码的 .mobileprovisionpasswordstring否证书密码默认空字符串在构造请求体前应确认文件内容已经正确 Base64 编码。若使用openssl base64 -in xxx.p12 -A这类命令注意选用-A选项去掉换行避免服务端解析失败。使用 curl 接入以下是一个可直接复制到终端的 curl 请求模板。需要先设置环境变量APIZERO_API_KEY并将cert、provision、password替换为真实值。curl -sS \ -X POST \ -H X-API-Key: $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {cert: cert, provision: provision, password: password} \ https://v1.apizero.cn/api/ios-cert其中cert的值是一整行 Base64 字符串注意不要包含换行符。provision同理。如果证书没有密码可以保留空字符串或省略该字段。返回参数解读成功时响应体为 JSONcode为 0msg为“成功”。以官方响应示例为基础data对象包含以下关键字段字段类型说明data.certificateobject证书信息例如is_revoked吊销状态、name证书名称、status状态描述data.mobileprovisionobject描述文件信息例如cert_end_days剩余天数、cert_type证书类型data.is_matchingboolean证书与描述文件是否匹配data.permissionsobjectentitlements 权限集合例如aps、debug、keychain等实际返回字段可能比示例更多、更细例如 Team ID、设备列表等。接入时应根据文档页的「响应示例」做字段兼容不要假设只存在示例中的字段。常见错误与处理建议由于文档没有给出完整错误码表这里给出按 HTTP 状态码和业务状态码两层的排查思路鉴权失败HTTP 401检查请求头中的 API Key 是否正确。如果密钥有效还需确认当前网络出口 IP 是否被服务端限制。参数错误HTTP 400检查cert和provision是否为空、是否包含非 Base64 字符。证书密码错误也可能导致解析失败返回非 0 的code。此时应核对密码并重新编码。触发频率限制HTTP 429 或业务码提示限流意味着请求频率超过 5 QPS。建议在客户端引入限速逻辑例如信号量或令牌桶。对需要重试的请求采用指数退避从 500ms 起步逐步增加重试间隔。服务端异常HTTP 5xx属于短期故障可重试。但仍需遵守 QPS 限制不能因为失败就并发重放。工程化注意事项密钥管理API Key 应存放于服务端环境变量或密钥管理服务中禁止出现在前端代码或仓库中。频率控制在调用层设置拦截器确保单实例并发数不超过 5。可以使用p-limitNode.js、SemaphoreGo或RateLimiterJava等工具。结果缓存证书吊销状态和到期日不会频繁变化建议对is_revoked、cert_end_days等字段设置缓存例如 6 小时减少重复调用。批量任务如果需要对历史证书全量检测建议将任务拆分为小批次按每分钟 60 次1200ms 间隔的节奏调度同时将中间状态写入数据库避免失败后全量重扫。日志与监控记录每次请求的响应码、耗时和上下文建立针对 429 的告警便于判断是否需要调整调度策略。参考文档文档页https://apizero.cn/aidocs/ios-cert原始文档https://apizero.cn/aidocs/ios-cert/raw.md
适用场景与能力边界iOS 证书与描述文件检测接口slug: ios-cert用于解析 .p12 证书和 .mobileprovision 描述文件。在一次请求内完成多维度校验证书有效期、吊销状态、Team ID、证书类型开发/分发/企业、设备列表、entitlements 权限清单同时验证证书与描述文件是否匹配。对于需要构建证书巡检、CI/CD 签名校验、内部证书管理工具的开发团队这个接口可作为核心检测模块。在使用前需要明确其能力边界。接口按单次请求处理一份证书与一份描述文件不支持批量文件上传也没有计划任务接口。更关键的是接口的 QPS 限制为 5/s即每秒最多处理 5 个请求。这个限制决定了它不适合对大量证书进行高并发扫描。例如在短时间内校验 100 份证书如果直接用循环并发请求会很快触发限流。因此接入方必须在客户端做好频率控制和任务排队。调用限制与用量边界QPS 5/s 是一个相对严格的频率约束。从工程角度看这意味着单次请求的平均间隔应大于等于 200ms。无法通过多线程/并发来提高单位时间内的处理量。若需要批量检测只能将任务串行化或分散到多个时间窗口。接口未提供内建的重试机制401/429 等响应需要调用方自行处理。这里需要区分“QPS 限制”与“总调用量限制”。文档页并未说明月度或日调用总量因此建议以文档页的官方说明为准。在接入时建议将从接口获取的证书信息做缓存例如将is_revoked、cert_end_days等结果保存到本地数据库设置合理的缓存过期时间从而减少不必要的重复请求。鉴权与请求头接口文档列出的两个 Header 参数Authorization必填stringContent-Type必填string对应 application/json需要留意官方 curl 示例中使用了X-API-Key请求头传递 API Key。两种鉴权方式可能在不同版本中存在差异具体以文档页为准。无论使用哪种方式调用前都应确认密钥有效并避免在客户端代码中硬编码密钥。请求体参数接口采用 POST 方法地址为https://v1.apizero.cn/api/ios-cert。请求体是一个 JSON 对象包含三个字段字段类型必填说明certstring是Base64 编码的 .p12 文件内容provisionstring是Base64 编码的 .mobileprovisionpasswordstring否证书密码默认空字符串在构造请求体前应确认文件内容已经正确 Base64 编码。若使用openssl base64 -in xxx.p12 -A这类命令注意选用-A选项去掉换行避免服务端解析失败。使用 curl 接入以下是一个可直接复制到终端的 curl 请求模板。需要先设置环境变量APIZERO_API_KEY并将cert、provision、password替换为真实值。curl -sS \ -X POST \ -H X-API-Key: $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {cert: cert, provision: provision, password: password} \ https://v1.apizero.cn/api/ios-cert其中cert的值是一整行 Base64 字符串注意不要包含换行符。provision同理。如果证书没有密码可以保留空字符串或省略该字段。返回参数解读成功时响应体为 JSONcode为 0msg为“成功”。以官方响应示例为基础data对象包含以下关键字段字段类型说明data.certificateobject证书信息例如is_revoked吊销状态、name证书名称、status状态描述data.mobileprovisionobject描述文件信息例如cert_end_days剩余天数、cert_type证书类型data.is_matchingboolean证书与描述文件是否匹配data.permissionsobjectentitlements 权限集合例如aps、debug、keychain等实际返回字段可能比示例更多、更细例如 Team ID、设备列表等。接入时应根据文档页的「响应示例」做字段兼容不要假设只存在示例中的字段。常见错误与处理建议由于文档没有给出完整错误码表这里给出按 HTTP 状态码和业务状态码两层的排查思路鉴权失败HTTP 401检查请求头中的 API Key 是否正确。如果密钥有效还需确认当前网络出口 IP 是否被服务端限制。参数错误HTTP 400检查cert和provision是否为空、是否包含非 Base64 字符。证书密码错误也可能导致解析失败返回非 0 的code。此时应核对密码并重新编码。触发频率限制HTTP 429 或业务码提示限流意味着请求频率超过 5 QPS。建议在客户端引入限速逻辑例如信号量或令牌桶。对需要重试的请求采用指数退避从 500ms 起步逐步增加重试间隔。服务端异常HTTP 5xx属于短期故障可重试。但仍需遵守 QPS 限制不能因为失败就并发重放。工程化注意事项密钥管理API Key 应存放于服务端环境变量或密钥管理服务中禁止出现在前端代码或仓库中。频率控制在调用层设置拦截器确保单实例并发数不超过 5。可以使用p-limitNode.js、SemaphoreGo或RateLimiterJava等工具。结果缓存证书吊销状态和到期日不会频繁变化建议对is_revoked、cert_end_days等字段设置缓存例如 6 小时减少重复调用。批量任务如果需要对历史证书全量检测建议将任务拆分为小批次按每分钟 60 次1200ms 间隔的节奏调度同时将中间状态写入数据库避免失败后全量重扫。日志与监控记录每次请求的响应码、耗时和上下文建立针对 429 的告警便于判断是否需要调整调度策略。参考文档文档页https://apizero.cn/aidocs/ios-cert原始文档https://apizero.cn/aidocs/ios-cert/raw.md
