开发者
你的农场出事了 指向任何您想要的 URL 。
每个农场最终都想要一些没有卖家的船只:谷仓电视上的仪表板,一个对警报作出反应的自家灌溉控制器,一个县级报告脚本,一个我们从未听说过的软件桥梁. 通常的答案是在计时器上投票给API,
更好的答案是生产系统互相使用:当发生事情时,推,签,重试直到着陆.
如何实际运作
FarmHubPOSTs 将 JSON 签名到您配置的 HTTPS URL, 当您关心的事件发生时 。
- 6种事件类型,随其发生而推. 记录收割情况,提出警示,解除警示,采取整改行动,启动召回,生成报告. 每个事件 POST 以 JSON 结尾,并在标题中标明事件名称 。
- 每个有效载荷都是HMAC-SHA256号的 FarmHub生成连接的签名密钥并签名每个请求主体,以 X- 发送签名FarmHub- 签名信头 将HMAC重制在生体之上并进行比较. 如果它不匹配,它不是来自我们。
- 送货重试与退货。 如果您的终点已下调或返回错误,FarmHub复以退转. 每次送货都带一个独特的送货ID头,这样你的处理器就可以破译复写.
- 有效载荷是版本的,你控制升级. 当有效载荷形状改变时,该版本被撞到,现有的连接一直被固定在它们的版本上直到你选择加入. 你们的整合不会因为我们运了一个球场而中断
是我们背后的送货机器Slack,团队,和PagerDuty融合 目的地交给你了
你可以调用
你可以指望着什么
确切地说,这些保证:
- FarmHub生成签名密钥。 HMAC密钥在连接时间创建,并在连接上存储加密. 没有共同的全球秘密,而旋转连接的钥匙只影响这种连接。
- 为真正的处理者建造了信头. 每一个请求都带有签名,事件名称,以及一个独特的交付代号,这样你就可以验证,路由,并且不首先解析身体.
- 紧急关闭。 立即关闭连接, 发送停止 。 当您的端点行为不当或您正在旋转基础设施时有用 。
- 连锁审计 每一次送货尝试都记录在审计日志中,其行数为散列,因此所送地点的历史不言自明。
我们不做的事情
诚实的界限:
- 交货时间至少是一秒,不是一秒。 退货意味着你的接线员可能会看到两次送货 递送身份证明的复制件。
- Webhooks只出门。 此集成不接受输入的数据; 它会告诉你的系统在FarmHub。 。 。
- 以上六种活动是今天的船. 我们宁可列举6个真实事件,也不愿承诺我们尚未建立的目录。
诚实设置
你需要一个HTTPS端点,可以接收一个JSON POST.
- 内FarmHub,打开集成,选择自定义 Webhook,并输入您的端点 URL。FarmHub生成 HMAC 签名密钥。
- 在你的处理器, 验证X -FarmHub-通过重算HMAC -SHA256 与签名密钥的原始请求机体的签名头.
- 以2xx快速响应; 进行重处理 ASync. Non-2xx回应以反弹重审.
- 触发测试发送,并在依赖种子之前确认您的签名验证通过.
农民问的问题
我该如何验证一个网棍来自FarmHub? 。 。 。
使用连接的签名密钥对原始请求体进行HMAC-SHA256的计算,并将其与X比对.FarmHub- 标志头,上面带有先缀为sha256=的六分位文摘。 拒绝任何不匹配的东西。
我同意什么活动?
记录收割情况,提出警示,解除警示,采取整改行动,启动召回,生成报告. 活动名称在X...FarmHub- 晚间新闻
如果我的终点下降怎么办?
FarmHub以退转重试送. 因为快递是最快的, 你的处理器应该用X去掉...FarmHub- 发送ID头。
有效载荷会改变我的整合吗?
没有 有效载荷是版本的,你的连接一直固定在有效载荷版本上,直到你选择进入新的版本.
我能旋转签名钥匙吗?
每个连接都有自己的FarmHub- 生成的密钥已加密 。 重联发布新密钥 杀机开关在旋转时立即停止交付.
准备下一场比赛
建造我们没想到的东西
点FarmHub\u2019s在自己的端点上签了事件流,并将农场线到任何你能想象的东西:谷仓仪表板,控制器,报告机器人. 你不需要我们的许可 只要一个URL
免费开始