本文先基于当前开放平台能力（服务端 API、移动端 SDK、照片验真 API）整理首版问题。
后续你可以按真实客户问题持续补充。
1. 开放平台目前提供哪些能力？
当前主要提供三类能力：服务端 API、移动端 SDK、照片验真 API。你可以按业务场景选择单独接入，也可以组合使用。
2. 我应该优先接入 API 还是 SDK？
如果你主要在服务端做统一处理、批量拉取和分析，优先选 API；如果你要在移动端快速完成拍照取证、现场采集，优先选 SDK。很多项目会采用 SDK 采集 + API 汇聚的组合方案。
3. 首次接入需要准备什么？
建议先明确业务场景与数据流，再在控制台申请凭证并阅读对应文档：服务端 API 文档、SDK 接入文档、验真 API 文档。接入前需确认调用频率、回调地址和异常重试策略。
4. 是否支持分阶段上线？
支持。建议先从单场景小流量灰度验证，再逐步扩大到全量业务，便于验证稳定性与识别效果。
5. 服务端 API 适合什么场景？
适合后台批处理、数据同步、组织架构联动、统一审计、与现有业务系统做深度集成等场景。
6. API 鉴权方式是什么？
平台提供基于签名的鉴权机制（文档有完整签名示例和参数说明）。建议在服务端统一封装签名逻辑，避免在多个业务模块重复实现。
7. 调用失败时如何排查？
优先检查请求参数完整性、签名是否正确、时间戳是否有效、网络连通性及权限范围。建议记录请求 ID 与错误码，便于快速定位。
8. 是否支持异步处理与结果回调？
支持异步处理场景。建议配置回调地址，并在业务侧实现幂等处理和重试机制，避免重复消费。
当前文档覆盖 iOS、Android、鸿蒙、Flutter、H5、Uni-app、微信小程序等主流平台，可根据你现有技术栈选择。
10. SDK 集成周期一般多久？
标准场景通常可在较短周期内完成基础接入；若涉及深度 UI 定制、复杂流程编排或多端统一改造，周期会相应增加。
11. SDK 是否支持水印与拍照流程定制？
支持按业务需求做配置化定制，常见包括拍照流程控制、水印展示策略、回传参数扩展等。
12. 如何保证终端采集稳定性？
建议在弱网、低端机、权限拒绝、后台切前台等场景做专项测试，并对超时、重试、失败兜底进行统一处理。
13. 验真 API 可以识别什么风险？
可用于识别照片真实性风险，如篡改、伪造、异常处理链路等。最终应结合业务规则做综合判断。
14. 验真接口是同步还是异步？
支持异步批量处理模式，适合大规模图片任务。建议业务侧用任务状态轮询或回调机制跟进处理结果。
15. 验真结果如何用于业务决策？
常见做法是将验真结果与风控规则、业务上下文（时间、地点、人员、设备）组合，分级触发自动放行、人工复核或拦截。
16. 验真能力是否可与现有风控系统集成？
可以。建议通过统一网关或中台服务对接，并建立标准字段映射与审计日志，降低后续维护成本。
17. 数据传输是否加密？
建议全链路使用 HTTPS，并在服务端进行密钥安全管理。涉及敏感字段时可增加业务侧二次加密与脱敏。
18. 如何做权限隔离与最小授权？
建议按应用、环境、业务线拆分凭证与权限范围，避免单一凭证覆盖全部业务，降低风险暴露面。
19. 是否建议保留调用审计日志？
建议保留。至少记录请求时间、请求 ID、调用方、关键参数摘要、返回码与耗时，便于审计与故障追溯。
20. 如何申请试用或商务咨询？
可通过门户中的“免费试用 API”或“预约方案咨询”入口提交信息，获取接入建议与商务支持。
21. 遇到线上问题如何快速处理？
建议准备问题发生时间、接口名称、请求 ID、错误码、影响范围与复现条件，优先提交给技术支持进行联合排查。