浙政钉DING消息对接文档

专有钉钉平台：https://openplatform-portal.dg-work.cn/backendManage/#/docs?apiType=serverapi&docKey=

1.开发浙政钉应用步骤

​ 开发单位申请专有钉钉账户，前后端工程运行在自建服务器。 登录专有钉钉管理后台，创建一条应用app， 将登录连接配置到改配置列表中。 App Key App Secret

讯享网

1.1 这一点很重要 需先订阅开通ding消息服务的访问权限，不会会报错

OPF-B001-05-16-0002----------------》需先订阅开通服务的访问权限

1.2 将测试的人员加入浙政钉

1.3 查看用户详情有uid就是浙政钉accoundId

2.DING API开放接口V2

接口说明

DING API开放接口V2版本。

接口限制规则：

• 同一个应用相同消息的内容同一个用户一天只能接收一次。
• 同一个应用给同一个用户发送消息，ISV应用开发方式一天不得超过100次。

通知类型为电话语音钉的限制规则：

电话DING使用的阿里云的语音服务，ISV发DING也收到阿里云语音服务的流控管控，阿里云语音服务的流控规则&效果如下：

• 流控规则：针对同一个被叫号码。流控规则：1次/分钟、5次/小时、20次/天（24小时）。
• 流控效果：命中流控规则时，再对该被叫号码发送电话DING（无论通过DING接口还是通过客户端发送），实际不播出电话，只能收到应用内DING。

调试

在API Explorer中调试该接口。

基本信息

中文名：DING API开放接口V2

接口名：/ding/isv/send.json

所在目录：DING

调用方式：POST（HTTPS）

发布版本：V2.7.0

请求参数

返回参数

用法DEMO

调用示例

 / *@Description: ding消息 *@Parameter: [creator 发送浙, receivers 接收者, dingBody 发送消息] *@Return: java.lang.String *@Author: jxj *@Date: 2022/7/22 / public String sendNotice(String creator ,String receivers, String dingBody){ 
    ExecutableClient executableClient = ExecutableClient.getInstance(); executableClient.setAccessKey("xxxxxxxxxxxxxxxxxxx"); executableClient.setSecretKey("xxxxxxxxxxxxxxxxxxx"); executableClient.setDomainName("openplatform.dg-work.cn"); executableClient.setProtocal("https"); //executableClient要单例，并且使用前要初始化，只需要初始化一次 executableClient.init(); //浙政钉发送ding消息接口 String api = "/ding/isv/send.json"; PostClient postClient = executableClient.newPostClient(api); postClient.addParameter("bodyType", "text"); postClient.addParameter("creator", creator); postClient.addParameter("dingBodyTextType", "plaintext"); postClient.addParameter("dingBody", dingBody); postClient.addParameter("textType", "plaintext"); postClient.addParameter("source", "{\"extJson\":{\"msgId\":\"\"}, \"sourceId\":\" \",\"sourceName\":\"张硕\"}"); postClient.addParameter("body", "{'text':'当前版本过低，升级版本后可查看DING详情'}"); postClient.addParameter("scene", ""); postClient.addParameter("notifyType", "app"); postClient.addParameter("receivers", receivers); postClient.addParameter("tenantId", "53236"); postClient.addParameter("dingBodyContentType", "text"); postClient.addParameter("sendToIm", ""); postClient.addParameter("accountId", ""); postClient.addParameter("accountName", ""); postClient.addParameter("accountOrgName", ""); postClient.addParameter("accountOrgId", ""); postClient.addParameter("sourceId", ""); postClient.addParameter("extJson", ""); postClient.addParameter("sourceName", ""); postClient.addParameter("accountId", ""); postClient.addParameter("accountName", ""); postClient.addParameter("accountOrgName", ""); postClient.addParameter("accountOrgId", ""); String apiResult = postClient.post(); System.out.println(apiResult); executableClient.destroy(); return "ok"; } 

请求包结构体

讯享网{ 
    "body":"{\"text\":\"（当前版本过低，升级版本后可查看DING详情）\"}", "bodyType":"text", "creator":{ 
    "accountId":, "accountName":"周丽英", "accountOrgId":"GE_64e388fd7de8d885e895d5e", "accountOrgName":"杭州市公安局-AAA哈哈哈" }, "dingBody":"{\"text\":\"通知一下，晚上加班\"}", "dingBodyContentType":"text", "dingBodyTextType":"plaintext", "notifyType":"app", "receivers":[ { 
    "accountId":, "accountName":"冯世明", "accountOrgId":"pre.saas.zwdingding" } ], "sendToIm":false, "source":{ 
    "extJson":"{\"msgId\":\"\"}", "sourceId":"", "sourceName":"周丽英" }, "tenantId":"", "textType":"plaintext", "urge":false } 

返回结果

成功返回示例

{ 
   "success":true,"content":{ 
   "data":"","success":true}} 

失败返回示例

讯享网失败返回案例 

补充说明

总结：

1.测试账号必须在通讯录里

2.必须给应用加ding消息权限

1-05-15-0001 | ILLEGAL_ARGUMENT | 参数错误 |
| GDG-S001-05-99-0001 | SYSTEM_ERROR | 未知系统异常 |
| GDG-B001-05-16-0003 | MOZI_ACL_CHECK_ERROR | 接收人可见性过滤异常 |

总结：

1.测试账号必须在通讯录里

2.必须给应用加ding消息权限

3.传参务必转jsonString 字符串