Liberty Mutual — OpenInsurance 接口集成服务

交付清单

• 协议分析报告（OAuth2 / FIDO / Soft-OTP / 背景服务权限链路）
• OpenAPI 3.0（Swagger）完整规范 + mock server
• 理赔上载 + webhook 的可运行源码（Node.js / Python）与 iOS/Android SDK 示例
• Telemetry 接入指南（数据模型、批量策略、上报频率、压缩方案）
• 安全、隐私与合规建议（GDPR、州保险监管与数据保留）
• 自动化测试脚本与接口验收计划

接口示例：理赔创建（伪代码）

POST /api/v1/claims
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "policy_id": "LM-12345678",
  "insured": {"name":"张三","phone":"+1..."},
  "event": {"type":"vehicle_accident","occurred_at":"2025-11-20T08:15:00Z","location":{"lat":...,"lng":...}},
  "attachments": [
    {"url":"https://cdn.example.com/parts/abc.jpg","type":"image/jpeg","signature":"..."}
  ]
}

Response: {"status":"CREATED","claim_id":"CLM-20251120-0001","webhook_subscribed":true}

Telemetry 列表（建议模型）

示例字段：trip_id, device_id, start_ts, end_ts, events[{ts,type,value}], gps_trace (polyline or compressed), sample_rate, privacy_flags

API 集成要点（技术说明）

1. 授权：优先采用 OAuth2 Authorization Code + PKCE；对高风险操作（理赔确认、支付）要求二次签名（FIDO / 生物）或 Soft-OTP。
2. 图片/视频：支持分片上传、哈希校验与签名（避免重放）；提供 CDN + 预签名 URL 模式以减轻主 API 负担。
3. Telemetry：设备在后台缓存并按网络/电量策略批量上报；上报时以压缩/差分格式减少带宽。
4. Webhooks：建议实现重试策略、幂等 ID 与 HMAC 签名校验，提供订阅管理接口。
5. 隐私与合规：存储最小化、用户同意记录、分区化存储（按地区法规）与可删数据链路。
6. 离线场景：移动端应能脱机抓取证据（照片、位置），并在联网后安全上报与补签名。

性能与安全建议

• API 限流与速率分级（Claims 低频、Telemetry 高吞吐）
• 端到端加密、HSTS 与强制 TLS 1.2+
• 审计日志、访问控制（RBAC）与可导出的合规报告
• 移动端权限最小化，明确说明为何需要敏感权限（位置、麦克风、相机、前台服务）

关于我们

我们是一家专注于应用协议分析与合法授权接口集成的技术工作室，团队成员来自移动应用、安全、保险科技与云架构背景。我们提供端到端交付：协议分析 → API 设计 → 开发 SDK → 集成测试 → 合规建议与文档交付。

• 支持 Android / iOS 双平台 SDK 和后端示例代码（Node.js / Python / Go）
• 合规优先：GDPR / 地区保险监管 / 最小化数据保留策略
• 透明报价：起步 $300，可先交付核心模块再确认付款

联系方式

如需定制集成、协议分析或试点实现，请通过我们的联系方式页面发起项目：

访问联系方式 /contact.html

项目合作流程（典型）

1. 需求确认：您提供目标 App 名称（Liberty Mutual）与优先级场景（理赔、Telemetry、电子保单）。
2. 协议分析：2-6 个工作日，给出授权链路、可用端点与风险点。
3. 开发与验证：3-12 个工作日（视复杂度），交付 SDK、示例与 mock server。
4. 验收与交付：交付 OpenAPI、测试脚本、部署建议与合规清单。
5. 后续支持：运维与二次开发按月度/小时计费。

常见问题

Q: 我需要提供什么信息？

Q: 我们如何确保隐私合规？