🙅‍♀️发送名片消息

• URL: http://127.0.0.1:8898/v2/api

• 方法: POST

• 功能: 发送名片消息，也可用于发送链接消息、转发视频号消息、转发小程序消息、转发文件消息等。

查询参数

参数	必需性	示例值	描述
funcname	必需	MagicCgi	指定的函数名
timeout	必需	10	请求超时时间
wxid	必需	Wxid_xxxxxx	微信ID

请求体:

• CgiCmd: 表示特定的命令，示例中为522。

• CgiRequest: 包含具体的请求信息。

  • ToUserName: 消息接收者的用户名，示例为群聊ID。

  • Content: 名片消息的XML格式内容，需要自行组装。

  • MsgType: 消息类型，名片消息为42。

  • AtUsers: 被@的用户，留空表示不@任何人。

示例

{
  "CgiCmd": 522,
  "CgiRequest": {
    "ToUserName": "22338810507@chatroom",
    "Content": "<msg bigheadimgurl=\"http://wx.qlogo.cn/mmhead/ver_1/A3EqIaaiaXWZTdLIibLZNdwlAB1JynRAuhPTO44S84487nBTxrQXp7nAd6ohiaicgWdErfPcu4FvFM1YIA9wzaLKeb8f47ibq47gU9Plh7XTWvk4/0\" smallheadimgurl=\"http://wx.qlogo.cn/mmhead/ver_1/A3EqIaaiaXWZTdLIibLZNdwlAB5JynRAuhPTO44S84487nBTxrQXp7nAd6ohiaicgWdErfPcu4FvFM1YIA9wzaLKeb8f47ibq47gU9Plh7XTWvk4/132\" username=\"v3_020b3826fd030200000000009ac816440135f5000000501ea9a3dba12f95f6b60a0536a1adb6d1126cff82b1e1abc8f7fa9e98c839a700533f9f1dadf93c68546bc29157167e1480f423b707b41ee831777394b2e52f7174b8430dfc8ee47674f92b@stranger\" nickname=\"0rigin\" fullpy=\"origin\" shortpy=\"\" alias=\"\" imagestatus=\"4\" scene=\"17\" province=\"河\" city=\"中国大陆\" sign=\"\" sex=\"1\" certflag=\"0\" certinfo=\"\" brandIconUrl=\"\" brandHomeUrl=\"\" brandSubscriptConfigUrl=\"\" brandFlags=\"0\" regionCode=\"CN_Henan_Bnyang\" antispamticket=\"v4_000b908f0b04000001000000000076658b2b441e90552d584e97ad611000000050ded0b020927e3c97896a09d47e6e9e4f4813cb69c7863e4871dc7dda8a2f36b4bb90ad616a0857a4a8f7361db8deb0d004626dce8ab0bc944d4e0818cc70608494516e58aab62192f9c6b4139d221490770e24e63857828035b54dae26a96347864340d49df8295943b650ec52892bba2614711cb0e295ef75fe6724db69f7c42c2e73ffb1108c657960bba10036007e7b93decef056a079f23b4b870082ef38f4adf49a64860088ee51fa12620b304225b160b037d88e3b7d9a402c109d470bbcdcf8a44cc302c3d2b4796e6d6105edfe588082282fe88c6cb9594343e182b9e62acd98cd0b79@stranger\" />",
    "MsgType": 42,
    "AtUsers": ""
  }
}

---

请求示例

curl --location -g --request POST 'http://127.0.0.1:8898/v2/api?funcname=MagicCgi&timeout=10&wxid=Wxid_xxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "CgiCmd": 522,
    "CgiRequest": {
        "ToUserName": "22338810507@chatroom",
        "Content": "<msg bigheadimgurl=\"http://wx.qlogo.cn/mmhead/ver_1/A3EqIaaiaXWZTdLIibLZNdwlAB1JynRAuhPTO44S84487nBTxrQXp7nAd6ohiaicgWdErfPcu4FvFM1YIA9wzaLKeb8f47ibq47gU9Plh7XTWvk4/0\" smallheadimgurl=\"http://wx.qlogo.cn/mmhead/ver_1/A3EqIaaiaXWZTdLIibLZNdwlAB5JynRAuhPTO44S84487nBTxrQXp7nAd6ohiaicgWdErfPcu4FvFM1YIA9wzaLKeb8f47ibq47gU9Plh7XTWvk4/132\" username=\"v3_020b3826fd030200000000009ac816440135f5000000501ea9a3dba12f95f6b60a0536a1adb6d1126cff82b1e1abc8f7fa9e98c839a700533f9f1dadf93c68546bc29157167e1480f423b707b41ee831777394b2e52f7174b8430dfc8ee47674f92b@stranger\" nickname=\"0rigin\" fullpy=\"origin\" shortpy=\"\" alias=\"\" imagestatus=\"4\" scene=\"17\" province=\"河\" city=\"中国大陆\" sign=\"\" sex=\"1\" certflag=\"0\" certinfo=\"\" brandIconUrl=\"\" brandHomeUrl=\"\" brandSubscriptConfigUrl=\"\" brandFlags=\"0\" regionCode=\"CN_Henan_Bnyang\" antispamticket=\"v4_000b908f0b04000001000000000076658b2b441e90552d584e97ad611000000050ded0b020927e3c97896a09d47e6e9e4f4813cb69c7863e4871dc7dda8a2f36b4bb90ad616a0857a4a8f7361db8deb0d004626dce8ab0bc944d4e0818cc70608494516e58aab62192f9c6b4139d221490770e24e63857828035b54dae26a96347864340d49df8295943b650ec52892bba2614711cb0e295ef75fe6724db69f7c42c2e73ffb1108c657960bba10036007e7b93decef056a079f23b4b870082ef38f4adf49a64860088ee51fa12620b304225b160b037d88e3b7d9a402c109d470bbcdcf8a44cc302c3d2b4796e6d6105edfe588082282fe88c6cb9594343e182b9e62acd98cd0b79@stranger\" />",
        "MsgType": 42,
        "AtUsers": ""
    }
}'

---

返回响应

• HTTP 状态码: 200 表示成功。

• 内容格式: JSON。

• 数据结构:

  • CgiBaseResponse: 包含错误信息(ErrMsg)和返回代码(Ret)。

  • ResponseData: 包含消息ID(NewMsgId)和客户端消息ID(ClientMsgId)。

---

成功示例

{
  "CgiBaseResponse": {
    "ErrMsg": "操作成功",
    "Ret": 0
  },
  "ResponseData": {
    "NewMsgId": 123456789,
    "ClientMsgId": "abc-123"
  }
}