用途:为应用自有端点构建类型化的本地 Clari REST 客户端,而非编写宽泛的非官方 SDK。将 Revenue、v2 数据摄取与 Copilot 客户端分离,避免各自的 base URL、请求头、限制、schema 与变更策略相互串扰。
主要能力:按接口面拆分客户端;显式建模标识符、时间戳、分页、导出任务状态、错误体与可选字段;集中管理连接与响应超时、user-agent、针对可重试瞬时故障的有界重试及关联元数据;以显式状态机暴露任务的入队、状态、取消与结果操作;在边界处对响应做 schema 校验后再做领域映射,校验失败时保留脱敏后的原始错误 ID。
使用方式:先准备端点清单与固定的第一方契约指纹、语言原生 HTTP 与 schema 校验库,以及超时、重试、日志和密钥脱敏策略。认证头(apikey、partnerkey、X-Api-Key、X-Api-Password)只在对应传输层内构造,接受密钥引用而非字面值,并保证错误、追踪与快照中请求头被脱敏。用 Read 与 Grep 检查配置、契约、fixture、日志、schema 与现有测试;Write 或 Edit 仅用于已批准的计划、实现、测试或脱敏回执。未经操作者明确批准,不得对提供方数据执行签发、轮换、撤销、创建、更新、取消、删除、导出、摄取或发布。
适用场景:需要统一封装 Clari 接口、控制重试与轮询、保证类型安全与脱敏合规的应用代码。
限制:资料未提供具体价格、平台支持范围或性能数据;重试重复变更需显式幂等决策与人工复核,不能假定 POST 或 PUT 可安全重放;凭据错误应在网络 I/O 前失败。