浙政钉DING消息对接文档_opf-b001-05-16-0002

浙政钉DING消息对接文档

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

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\":\"834828 \",\"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";
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

请求包结构体

{
    "body":"{\"text\":\"（当前版本过低，升级版本后可查看DING详情）\"}",
    "bodyType":"text",
    "creator":{
        "accountId":143906377,
        "accountName":"周丽英",
        "accountOrgId":"GE_64e388fd7d954175916e8d885e895d5e",
        "accountOrgName":"杭州市公安局-AAA哈哈哈"
    },
    "dingBody":"{\"text\":\"通知一下，晚上加班\"}",
    "dingBodyContentType":"text",
    "dingBodyTextType":"plaintext",
    "notifyType":"app",
    "receivers":[
        {
            "accountId":143918250,
            "accountName":"冯世明",
            "accountOrgId":"pre.saas.zwdingding"
        }
    ],
    "sendToIm":false,
    "source":{
        "extJson":"{\"msgId\":\"\"}",
        "sourceId":"143906377",
        "sourceName":"周丽英"
    },
    "tenantId":"695716",
    "textType":"plaintext",
    "urge":false
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

返回结果

成功返回示例

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

失败返回示例

失败返回案例
1

补充说明

总结：

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 字符串