14.1 发送企微小微通知

请求参数

Query 参数

access_token

string

调用接口凭证

必需

Body 参数application/json

user_ids

array[string]

必需

消息接收者(不能为空)(最大1000)

msg_type

string

必需

消息类型（支持：textcard文本卡片，text文本消息；默认为textcard）

msg_obj

object

必需

title

string

可选

标题 (不能为空,消息类型为textcard时必传,且长度不能超过128个字节,超过自动截断)。

description

string

可选

描述 (不能为空,消息类型为textcard时必传,且长度不能超过512个字节,超过自动截断)。

url

string

可选

点击后跳转的链接。消息类型为textcard时必传,且最长2048字节，请确保包含了协议头(http/https),超过自动截断。

btn_txt

string

可选

按钮文字。消息类型为文本卡片时可传,默认为“详情”，不超过4个文字，超过自动截断。

content

string

可选

内容(消息类型为text时必传,其他类型时不传,最大长度为2048)

示例

{
    "user_ids": [
        "string"
    ],
    "msg_type": "string",
    "msg_obj": {
        "title": "string",
        "description": "string",
        "url": "string",
        "btn_txt": "string",
        "content": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi.weiling.cn/openapi/message/send?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_ids": [
        "string"
    ],
    "msg_type": "string",
    "msg_obj": {
        "title": "string",
        "description": "string",
        "url": "string",
        "btn_txt": "string",
        "content": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

返回结果码值-0:请求成功 500 系统错误

msg

string

返回结果信息

必需

data

object

必需

fail_list

array [object {4}]

失败列表

必需

success_list

array [object {4}]

成功列表

必需

示例

{
    "code": "",
    "msg": "",
    "data": {
        "fail_list": [
            {
                "errorCode": 0,
                "errorMsg": "",
                "toUser": "",
                "msgId": ""
            },
            {}
        ],
        "success_list": [
            {
                "errorCode": 0,
                "errorMsg": "",
                "toUser": "",
                "msgId": ""
            },
            {}
        ]
    }
}