#TAPD 集成

TAPD 集成用于把 TAPD 里的项目接入 HiFox：可以先导入已有条目，再按连接上的同步设置保持更新。

欢迎页已经提到可以接入 TAPD。具体入口在设置里的导入流程，以及外部应用集成。菜单名称以线上为准。

#两种凭证

TAPD 开放 API 有两种凭证。导入向导和同步连接都可以二选一，形态参照 Jira 导入的分段切换。

绑定页会用黄字写清这两点：

• 只有 TAPD 付费版才能用「API 账号」；免费版请改用「个人访问令牌」。
• 「个人访问令牌」仅支持从 HiFox 同步到 TAPD，不支持双向实时同步。双向实时同步需要 API 账号。

个人令牌下列出的是你参与的项目。实时同步方向以绑定页提示和线上开关为准。

#导入和同步

• 导入：把 TAPD 里已有的条目批量搬到 HiFox。适合迁历史数据。
• 同步：按连接上的方向，让之后的变更在两边保持更新。

如果连接上有「立即同步」，它是按需增量拉取，不是后台不停轮询。免费公司没有 webhook 时，可以用它补入站更新。

导入后的创建人会尽量保留 TAPD 原始创建人，不要一律显示成导入操作人。对于受支持的人员字段和评论作者，HiFox 会使用 TAPD 与 HiFox 的成员映射；无法匹配到 HiFox 成员时，界面会做兜底展示，具体文案以线上为准。

导入的标签归属于目标 Space，避免影响其他 Space 的标签选择器。如果组织中已经存在同名标签，导入会复用该组织标签，不再创建同名的 Space 标签。

#个人访问令牌限流

个人令牌触发 TAPD 限流时，导入界面会展示原因和预计恢复时间。额度恢复后导入会自动继续，一般不必重新发起。

不要把限流等待当成导入失败。普通失败仍走原来的失败提示。

#常见问题

#免费 TAPD 公司应该用哪种凭证？

用个人访问令牌。API 账号需要 TAPD 付费版。

#个人令牌能不能做双向实时同步？

不能。绑定页写明：个人访问令牌只支持 HiFox → TAPD 的单向实时同步。要双向实时同步，需要 API 账号。

#个人令牌要不要填 company_id？

不用。只填 token。可选项目是你参与的项目。