钉钉开发文档

回调协议

更新时间: 2018-12-3

注意:钉钉对ISV的回调推送支持两种方式,一种是HTTP回调URL推送方式,一种是钉钉云推送方式。
本小节所介绍的是HTTP回调URL方式,关于钉钉云推送,可以参考此文档详细了解。

在应用创建、企业授权开通应用等事件发生的时候,钉钉服务器端会向应用设置的回调地址推送数据。钉钉向应用推送的数据包,将使用应用创建后开发者填写的应用加解密key来进行加密,使用开发者填写的应用Token进行签名,应用在收到推送后需要进行验证签名和解密,并且返回包含经过加密的字符串的json数据。

主要有以下几个场景需要使用回调协议:

1 应用被创建后设置回调URL并验证有效性时:

a.验证回调URL有效性事件
b.应用回调地址更新事件

2 处于应用安全访问钉钉服务端API的考虑,钉钉定期向应用推送suite_ticket:

c.接收应用的suite_ticket

3 企业管理员在管理应用时:

d.企业授权开通应用事件
e.通讯录授权范围变更消息
f.应用逻辑停用事件
g.应用逻辑启用事件
h.解除企业授权事件

4 企业下单购买您的收费商品后,你可以通过回调事件拿到用户购买的商品规格对应的规格参数及企业购买的服务时长。与之对应的回调接口为:

i.用户购买下单事件

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!