钉钉开发文档

推送suite_ticket

更新时间: 2018-6-21

钉钉开放平台会向应用的回调URL不定期(约二十分钟)推送suite_ticket,注意:开发者需要持久化TICKET,也不要设置20分钟失效的缓存时间,新的ticket推送会使之前的ticket失效。

应用在收到ticket推送后务必返回经过加密的字符串"success"的json数据。

如果不返回,钉钉服务器将连续推送,直到推送次数超过100次,就不再推送。倘若您希望钉钉服务器重新推送,需要进入开发者后台,进入左侧ISV应用菜单, 进入应用列表。
应用列表.png

点击右侧齿轮状设置,进入应用首页,如下图
应用发布流程.png

再点击查看详情,点击『重新推送』按钮,即可重新推送。
undefined

POST数据解密后示例

{
  "SuiteKey": "suitexxxxxx",
  "EventType": "suite_ticket ",
  "TimeStamp": 1234456,
  "SuiteTicket": "adsadsad"
}
参数 说明
SuiteKey 应用的SuiteKey
EventType suite_ticket
TimeStamp 时间戳
SuiteTicket Ticket内容

返回参数说明

服务提供商在收到此事件推送后务必返回包含经过加密的字符串"success"的json数据。

{
  "msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",
  "timestamp":"1783610513",
  "nonce":"123456",
  "encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIBNbWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+ccC9ZjKs1wV5bmA9NoAWQiZ+7MpzQVq+j74rJQljdVyBdI/dGOvsnBSCxCVW0ISWX0vn9lYTuuHSoaxwCGylH9xRhYHL9bRDskBc7bO0FseHQQasdfghjkl" // "Random"字段的加密数据
}
参数 说明
msg_signature 消息体签名
timestamp 时间戳
nonce 随机字符串
encrypt "success"加密字符串