线性生产商
同步问题及其历史、评论、项目、倡议、周期、 文档、客户、发行版、发行说明,以及命名其id的列表 从一个线性工作区。它回填每个资源,轮询更改,并 使用webhook进行存档、删除和恢复。
配置
| 变量 | 要求 | 默认的 |
|---|---|---|
LINEAR_API_KEY | 是 | 无 |
LINEAR_WEBHOOK_SECRET | 是 | 无 |
设置
- 在线性设置>帐户>安全&下创建个人API密钥 访问。选择“Only select permissions”并勾选 读. 使用一个 专用用户,因为该键看到的是该用户看到的,包括他们的 私人团队。
- 作为一个工作区管理员,在Settings > Administration > API中添加一个webhook。点
在
https://<host>/webhooks/linear,选择所有公共团队,并勾选 每个数据更改类型。使用其签名密钥为LINEAR_WEBHOOK_SECRET. 对于每个可以读取密钥的私有团队,也为该团队添加一个webhook。 使用相同的URL并设置相同secret通过GraphQL API。
数据
- 归档和废弃的项目保留为行,与
archived_at和trashed. 删除的项得到_deleted在桌子上线性有:问题的网络钩子, 评论、附件、发行标签、用户、周期、项目、项目 更新、项目标签、计划、计划更新、文档、 客户,以及客户的需求。 - 其他表上的删除不可见,例如删除的关系或团队 成员。
issue_history每个更改有一行,其中包含前后值。projects.team_ids读取多达50个团队,以及member_ids高达100 成员。- 客户需要客户的要求打开。发行版需要商业计划。
- 表格保存姓名、电子邮件以及发布和评论文本。把他们当作 保密。
限制
- 一个API密钥每小时获得2,500个请求和3,000,000个复杂度点。一个 用完限制等待并再次尝试。
- 大型资源每5分钟轮询一次,命名id的列表每5分钟轮询一次 小时。
- 归档、垃圾和还原不会改变
updatedAt,所以只有网钩 看到他们。Linear在大约7小时内重试一个webhook 3次。
演示数据
pnpm demo --size 128MiB 写入没有线性凭证的虚构线性数据。
请参阅Connector Kit README,了解所需的标志和变量。
每个问题都有它的历史,评论,有时还有一个关系,一个GitHub拉 请求、客户请求和发布。工作空间写入一次,然后 不随规模增长:4个团队,16个用户, 两周的周期,8个有里程碑、更新和规范的项目,3个计划, 12个客户,一年每月发布一次。
地方发展
cd connectors/producer-linear
pnpm sandbox
pnpm start 运行托管连接器。它需要Wings和PostgreSQL
中的变量 连接器套件自述.