- Overview of OpenAPI
- SlackOpenAPI
- ShopifyOpenAPI
- GithubAPI
- DiscordOpenAPI
- 历史文档(不推荐)
- 开发钉钉应用
- 服务端API
- 新版服务端API(DingTalk OpenAPI)
- 生态伙伴API
获取工作通知消息的发送结果
POST
http://127.0.0.1/topapi/message/corpconversation/getsendresult
服务端API/消息通知/工作通知
最后修改时间:2022-08-30 09:19:22
责任人:未设置
说明#
服务地址:https://oapi.dingtalk.com
权限#
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 无需申请 | 调试 |
第三方企业应用 | 是 | 无需申请 | 调试 |
第三方个人应用 | 否 | — | — |
错误码#
错误码 | 描述 | 解决方案 |
---|---|---|
143103 | 企业单应用消息发送人次QPM超限 | 接口调用太快,稍后重试。 |
143104 | 企业每分钟发送人次QPM超限 | 接口调用太快,稍后重试。 |
143105 | 单应用给单人每日推送量超限 | 企业每天给每个员工最多可发送500条消息通知,ISV最多可发送50条。 |
143106 | 单应用给单人推送重复消息超限 | 给同一员工一天只能发送一条内容相同的消息通知。 |
143203 | ISV单应用发送给单企业人次QPM超限 | 接口调用太快,稍后重试。 |
143204 | ISV单应用发送给所有企业人次QPM超限 | 接口调用太快,稍后重试。 |
143205 | 单应用给单人每日推送量超限 | 企业每天给每个员工最多可发送500条消息通知,ISV最多可发送50条。 |
143206 | 单应用给单人推送重复消息超限 | 给同一员工一天只能发送一条内容相同的消息通知。 |
1430000 | 接受者为空 | 接受者不能为空。 |
1430001 | 未识别的grantType | 无。 |
1430002 | 包含违禁内容 | 检查消息文本中是否有黄色、反动等词语。 |
1430003 | 触发OAPI系统保护 | 无。 |
1430004 | 超级高管保护 | 关闭高管保护。 |
请求参数
Query 参数
access_token
string
必需
示例值:
6d1bxxxx
Body 参数application/json
agent_id
number
必需
task_id
number
必需
示例
{
"agent_id": 123,
"task_id": 456
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/message/corpconversation/getsendresult?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"agent_id": 123,
"task_id": 456
}'
返回响应
🟢200成功
application/json
Body
send_result
object
返回结果。
invalid_user_id_list
array[string]
可选
forbidden_user_id_list
array[string]
可选
failed_user_id_list
array[string]
可选
read_user_id_list
array[string]
可选
unread_user_id_list
array[string]
可选
invalid_dept_id_list
array[number]
无效的部门ID。
forbidden_list
array [object {3}]
可选
errcode
number
返回码。
errmsg
string
返回码描述。
request_id
string
请求ID。
示例
{
"send_result": {
"invalid_user_id_list": [
"string"
],
"forbidden_user_id_list": [
"string"
],
"failed_user_id_list": [
"string"
],
"read_user_id_list": [
"string"
],
"unread_user_id_list": [
"string"
],
"invalid_dept_id_list": [
0
],
"forbidden_list": [
{
"code": "string",
"count": 0,
"userid": "string"
}
]
},
"errcode": 0,
"errmsg": "string",
"request_id": "string"
}
