🌳发送APP消息

发送APP消息接口文档

接口描述

• 功能：此接口用于发送链接消息、转发视频号消息、转发小程序消息、转发文件消息。

• 方法：POST

• URL：v2/api

---

请求示例

示例

{
  "CgiCmd": 222,
  "CgiRequest": {
    "ToUserName": "6949093048@chatroom",
    "AppMsgXml": "<appmsg appid=\"wx6618f1cfc6c132f8\" sdkver=\"0\"><title>Gemini.pdf</title><type>6</type><action>view</action><appattach><totallen>1714122</totallen><fileext>pdf</fileext><attachid>@cdn_3057020100044b30490201000204d26d70fe02032f4dc502043a29642a020465781db2042465336231396130342d633334662d346365352d386535302d3961343464383366383862630204052400050201000405004c537500_6dfb7e6c7f6a1dfb985634e2446be1ea_1</attachid><cdnattachurl>3057020100044b30490201000204d26d70fe02032f4dc502043a29642a020465781db2042465336231396130342d633334662d346365352d386535302d3961343464383366383862630204052400050201000405004c537500</cdnattachurl><cdnthumbaeskey /><aeskey>6dfb7e6c7f6a1dfb985634e2446be1ea</aeskey><encryver>0</encryver><filekey>6849093048@chatroom_191_1702370736</filekey><overwrite_newmsgid>6186776090082344827</overwrite_newmsgid><fileuploadtoken>v1_86yFZJW34nwSI4+TGjP4CDUr086eDFTKcR9foPS8oCofWqpwMc4i61wfB/0uwN/iZHT0a1mNU57BNVq6BWNcCCkifUxebXRKIBI3B/yVGPlEAxvAybgEOSQsCvG7lU5MilOzhCxbPLhu1KFEQWYhfp2bym4jxmjVd4putxLzLwTLHIi6Tjh+qjcWw13oP/DKznJdboFJuowXfg==</fileuploadtoken></appattach><md5>b1a08644e75e2eba3ce6ed5ff358c876</md5><webviewshared><jsAppId><![CDATA[]]></jsAppId><publisherReqId><![CDATA[0]]></publisherReqId></webviewshared></appmsg>",
    "MsgType": 49
  }
}

---

请求参数

Query 参数

参数	类型	描述	示例值
funcname	string	必需	MagicCgi
timeout	string	必需	10
wxid	string	必需	Wxid_xxxxx

Body 参数

• CgiCmd (integer) 必需

• CgiRequest (object) 必需

  • ToUserName (string) 必需

  • AppMsgXml (string) 必需 注意转义，转义后的XML内容从appmsg这个节点开始

  • MsgType (integer) 必需

---

示例代码

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": 222,
    "CgiRequest": {
        "ToUserName": "6949093048@chatroom",
        "AppMsgXml": "<appmsg appid=\"wx6618f1cfc6c132f8\" sdkver=\"0\"><title>Gemini.pdf</title><type>6</type><action>view</action><appattach><totallen>1714122</totallen><fileext>pdf</fileext><attachid>@cdn_3057020100044b30490201000204d26d70fe02032f4dc502043a29642a020465781db2042465336231396130342d633334662d346365352d386535302d3961343464383366383862630204052400050201000405004c537500_6dfb7e6c7f6a1dfb985634e2446be1ea_1</attachid><cdnattachurl>3057020100044b30490201000204d26d70fe02032f4dc502043a29642a020465781db2042465336231396130342d633334662d346365352d386535302d3961343464383366383862630204052400050201000405004c537500</cdnattachurl><cdnthumbaeskey /><aeskey>6dfb7e6c7f6a1dfb985634e2446be1ea</aeskey><encryver>0</encryver><filekey>6849093048@chatroom_191_1702370736</filekey><overwrite_newmsgid>6186776090082344827</overwrite_newmsgid><fileuploadtoken>v1_86yFZJW34nwSI4+TGjP4CDUr086eDFTKcR9foPS8oCofWqpwMc4i61wfB/0uwN/iZHT0a1mNU57BNVq6BWNcCCkifUxebXRKIBI3B/yVGPlEAxvAybgEOSQsCvG7lU5MilOzhCxbPLhu1KFEQWYhfp2bym4jxmjVd4putxLzLwTLHIi6Tjh+qjcWw13oP/DKznJdboFJuowXfg==</fileuploadtoken></appattach><md5>b1a08644e75e2eba3ce6ed5ff358c876</md5><webviewshared><jsAppId><![CDATA[]]></jsAppId><publisherReqId><![CDATA[0]]></publisherReqId></webviewshared></appmsg>",
        "MsgType": 49
    }
}'

---

返回响应

• HTTP 状态码: 200

• 内容格式: JSON

抱歉，让我们继续完成返回响应部分的数据结构说明。

数据结构

• CgiBaseResponse (object) 必需

  • ErrMsg (string) 必需 - 错误消息

  • Ret (integer) 必需 - 返回码，0 表示成功

• ResponseData (object) 必需

  • NewMsgId (integer) 必需 - 新消息的ID

  • ClientMsgId (string) 必需 - 客户端消息ID

响应示例

{
  "CgiBaseResponse": {
    "ErrMsg": "string",
    "Ret": 0
  },
  "ResponseData": {
    "NewMsgId": 0,
    "ClientMsgId": "string"
  }
}