Mitti（原 SafetyCulture）
Mitti 是 SafetyCulture 的新名称。本只读数据源通过 Mitti Data Feeds API 将运营数据同步到 Daspire 目的地。原 SafetyCulture 和 iAuditor 用户应选择此连接器。
前置条件
- Mitti Premium 或 Enterprise 组织。
- 能查看待同步记录的用户或 Service User。
- Mitti API Token。共享或长期运行的管道应使用 Service User Token，避免集成绑定到员工个人账号。
- 增量数据首次回溯的最早 UTC 日期和时间。
在 Mitti 账号设置中创建 Token，并只授予需要的读取权限。用户、用户组和成员关系 Feed 需要相应的平台管理权限；站点和记录可见范围仍受 Token 所有者权限约束。
官方参考：
配置数据源
- 在 Daspire Source Catalog 中选择 Mitti (formerly SafetyCulture)。
- 输入 API Token。Daspire 将其按 Secret 存储，不会发送到客户自定义 Host。
- 设置 Start date，使用 Internet Date-Time 格式，例如
2026-01-01T00:00:00Z。 - Page size 默认保留 100，除非支持人员要求降低。
- 点击 Save & Test，发现 Schema 后选择需要复制的 Streams。
连接器只向 https://api.mitti.com 发送请求，不执行供应商写操作，也不下载检查媒体、PDF 或 Word 文件。
支持的数据流
| Stream | 主键 | Source 同步模式 |
|---|---|---|
inspections | id | Full refresh；按 modified_at 增量 |
inspection_items | id | Full refresh；按 modified_at 增量 |
templates | id | Full refresh；按 modified_at 增量 |
actions | id | Full refresh；按 modified_at 增量 |
template_permissions | id | Full refresh |
sites | id | Full refresh |
site_members | site_id, member_id | Full refresh |
users | id | Full refresh |
groups | id | Full refresh |
group_users | group_id, user_id | Full refresh |
action_assignees | id | Full refresh |
action_timeline_items | id | Full refresh |
issues | id | Full refresh |
issue_assignees | id | Full refresh |
issue_relations | id | Full refresh |
issue_timeline_items | id | Full refresh |
assets | id | Full refresh |
增量任务会冻结本次同步的时间上界，并从上次 Checkpoint 向前回看 5 分钟。增量流应使用 Source 主键执行 append + deduped；全量流使用 overwrite。
当 Data Feeds API 可提供相应记录时，连接器会包含归档和已完成检查、归档模板、inactive 检查项、已删除站点及完整站点层级。assets.fields 保留供应商原始字符串格式。
Mitti Data Feeds 不返回已硬删除的 inspection 或 action。由于本 Beta 不包含 activity logs，使用增量 append + deduped 时，目的地会保留这些记录最后一次同步的版本；如果下游必须与删除状态完全一致，应定期执行 full-refresh overwrite。参见 Mitti 已删除数据说明。
权限与空数据
Save & Test 只会对 inspections 发起一次低成本请求，不会预检全部 17 个 Feed。permission_denied 表示 Mitti 对所选 Feed 返回 HTTP 403，Daspire 不会把该错误转换为空表。但当 Token 所有者缺少相应管理权限时，Mitti 可能对 users 或 groups 返回 HTTP 200 和空数据；这与组织确实没有数据无法区分。请授予官方说明中的权限，并在首次同步中逐流验证。
Token 按组织隔离。每个 Mitti 组织应分别创建 Daspire Source 和 API Token。
故障处理
invalid_token：创建或重新启用 Token，并更新 Source Secret。permission_denied：向 Token 所有者授予相应数据访问权和平台管理权限。rate_limited：Daspire 会自动遵循 Mitti 的重试窗口；如果持续限流，应减少重叠计划。provider_contract_changed：API 返回了不安全分页 URL、异常响应结构或不推进的分页游标。不要无限重试，请联系 Daspire 支持。
本 Beta 版本不支持 schedules、training、activity logs、webhooks、写接口以及媒体或报表文件下载。