- Overview of OpenAPI
- SlackOpenAPI
- ShopifyOpenAPI
- GithubAPI
- DiscordOpenAPI
- 历史文档（不推荐）
- 开发钉钉应用
- 服务端API
- 新版服务端API（DingTalk OpenAPI）
- 生态伙伴API
发送服务窗单人消息
POST
http://127.0.0.1/v1.0/crm/officialAccounts/oToMessages/send
服务端API/互联平台/服务窗
最后修改时间：2022-08-30 09:19:22
责任人：未设置
说明#
服务地址：api.dingtalk.com
权限#
| 应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 服务窗发送消息权限 | API Explorer |
| 第三方企业应用 | 暂不支持 | 服务窗发送消息权限 | 暂不支持 |
| 第三方个人应用 | 暂不支持 | 服务窗发送消息权限 | 暂不支持 |
错误码#
| HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
| 400 | illegalParameter | Illegal parameter | 参数错误 |
| 400 | idempotentParameterMismatch.uuid | uuid not found. | uuid参数非法。 |
| 400 | illegalParameter.uuid | illegal uuid. | uuid参数非法。 |
| 400 | illegalParameter.messageContent | illegal message content. | 消息内容不合法。 |
| 400 | illegalParameter.messageBody | illegal message body. | 消息体不合法。 |
| 400 | illegalParameter.messageType | illegal message type. | 消息类型不合法。 |
| 400 | illegalParameter.messageReceiver | illegal message receiver. | 消息接收人不正确。 |
| 400 | illegalParameter.account | illegal account. | 服务窗帐号异常。 |
| 400 | illegalRequest.overQuota | request over quota. | 请求超过配额。 |
| 500 | systemError | system error. | 系统异常。 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
Body 参数application/json
detail
object
消息详情。
msgType
string
消息类型。
uuid
string
必需
userId
string
必需
messageBody
object
消息体。
bizId
string
可选
accountId
string
账号id。
示例
{}示例代码
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/v1.0/crm/officialAccounts/oToMessages/send' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'返回响应
🟢200成功
application/json
Body
requestId
string
请求ID。
result
object
返回结果。
openPushId
string
可选
示例
{
"requestId": "string",
"result": {
"openPushId": "string"
}
}
修改于 2022-08-30 09:19:22