钉钉服务接口设计

一、钉钉服务交互相关接口：

1、流程开始请求建群：

请求地址：

dingtalk/api/chat/createChat
复制代码

请求包结构：

{
    "name": "groupName",
    "owner": "zhangsan",
    "useridlist": ["zhangsan","lisi"]
}
复制代码

参数说明：

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "chatid": "chatxxxxxxxxxxxxxxxxxxx",
}
复制代码

2、流程运转请求修改群：

请求地址：

dingtalk/api/chat/updateChat
复制代码

请求包结构：

{
    "chatid": "chatxxxxxxxxxxxxxxxxxxx",
    "name": "群名称",
    "owner": "zhangsan",
    "add_useridlist": ["lisi"],
    "del_useridlist": ["wangwu"]
}
复制代码

参数说明：

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
}
复制代码

3、发送群消息

请求地址：

dingtalk/api/chat/sendChatMessage
复制代码

请求包结构：

{
    "chatId": "xxx",
    "msg": "xxx",
}
复制代码

参数说明

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
}
复制代码

4、发送工作通知

请求地址：

dingtalk/api/message/sendWorkMessage
复制代码

请求包结构：

{
    "agent_id": 1234, 
    "userid_list": "ok",
    "msg": {"msgtype":"text","text":{"content":"消息内容"}}
}
复制代码

参数说明

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "task_id":123  // 工作消息的id
}
复制代码

转载于:https://juejin.im/post/5c4a752ae51d4533de6e1820