对接范围
投户外为标准多租户 SaaS 平台，对外提供的数据与集成能力按需评估、授权开通，不在公网公开完整接口文档。常见对接需求包括：
- 与甲方或集团系统的数据同步（媒体资源、任务执行、报表数据）；
- 单点登录（与既有账号体系打通）；
- 财务/ERP 取数（合同、回款、外采成本）；
- 广告主侧或第三方平台的方案与执行数据回传。
对接流程
- 需求评估：与客户成功或售前确认对接范围、字段口径与频率；
- 授权与环境：开通对接凭证（密钥）、配置访问白名单，提供联调环境；
- 联调与验收：按接口清单完成联调，核对数据口径与异常处理；
- 上线与运维：约定监控与告警方式，接口变更提前通知。
技术约定
- 接口基于 HTTPS 提供，请求需携带授权凭证；
- 响应为统一结构（状态码、消息、数据体、请求编号），分页接口返回页码、总数与是否还有下一页；
- 接口调用受频率限制保护，超限返回明确错误码；
- 错误响应中带有请求编号（traceId），反馈问题时请一并提供，便于快速定位。
安全要求
- 对接凭证仅用于约定用途，不得写入前端代码或公开仓库；
- 建议按 IP 白名单限制调用来源，并定期轮换凭证；
- 涉及个人信息（联系人、手机号）的字段需遵守双方的数据合规约定。
需要对接请通过客户成功渠道提交需求，我们会提供接口清单、字段说明与联调支持。