钉钉开发文档

回调协议

更新时间: 2018-6-29

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

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

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

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

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

c.接收应用的suite_ticket

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

d.企业授权开通应用事件

e.通讯录授权范围变更消息

f.应用逻辑停用事件

g.应用逻辑启用事件

h.解除企业授权事件

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

i.用户购买下单事件