钉钉开发文档

通讯录授权范围变更事件

更新时间: 2018-10-19

当授权方(即授权企业)在钉钉手机客户端-微应用管理中,修改了对应用的授权企业通讯录范围后,钉钉服务器会向服务提供商创建应用时填写的回调URL推送授权变更消息。注意:推送的授权变更信息并不包括企业用户具体做了什么修改,所以收到推送之后,ISV需要通过调用获取通讯录权限接口查询新的授权范围。

POST数据解密后示例

{
  "SuiteKey": "suitexxxxxx",
  "EventType": " change_auth",
  "TimeStamp": 1234456,
  "AuthCorpId": "xxxxx"
}

字段说明

参数 说明
SuiteKey 应用的SuiteKey
EventType change_auth
TimeStamp 时间戳
AuthCorpId 授权方企业的corpid

返回参数说明

服务提供商在收到此事件推送后务必返回包含经过加密的字符串"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"加密字符串