個(gè)人微信開(kāi)發(fā)API協(xié)議
一团赁、基礎(chǔ)消息類(lèi)型
1、客戶(hù)端發(fā)送的心跳包HeartBeatReq=1001;
2谨履、消息接收確認(rèn)回復(fù)(接收或拒絕接收)MsgReceivedAck =1002;
3欢摄、錯(cuò)誤單獨(dú)提升為一種消息類(lèi)型 Error = 1003;
4、通用任務(wù)執(zhí)行結(jié)果通知TaskResultNotice=1025;
二屉符、設(shè)備客戶(hù)端授權(quán)類(lèi)消息
1剧浸、設(shè)備(手機(jī)客戶(hù)端锹引、客服客戶(hù)端)獲取通信token請(qǐng)求與響應(yīng)
DeviceAuthReq=1010;
設(shè)備(手機(jī)客戶(hù)端矗钟、客服客戶(hù)端)獲取通信 token 響應(yīng) DeviceAuthRsp =1011;
2、設(shè)備授權(quán)后退出(僅用于服務(wù)端內(nèi)部)DeviceExitNotice = 1012;
3嫌变、賬號(hào)強(qiáng)制下線(xiàn)通知AccountForceOfflineNotice =1013;
三吨艇、手機(jī)客戶(hù)端上傳的通知類(lèi)消息
1、手機(jī)客戶(hù)端微信上線(xiàn)通知WeChatOnlineNotice = 1020;
2腾啥、手機(jī)客戶(hù)端微信下線(xiàn)通知WeChatOfflineNotice =1021;
3东涡、微信個(gè)人號(hào)新增好友通知FriendAddNotice =1022;
4、微信個(gè)人號(hào)移除好友通知FriendDelNotice =1023;
5倘待、微信好友發(fā)來(lái)聊天消息通知FriendTalkNotice =1024;
6疮跑、手機(jī)上回復(fù)好友的聊天消息通知WeChatTalkToFriendNotice =1026;
7、有好友請(qǐng)求添加好友的通知FriendAddReqeustNotice = 1027;
8凸舵、手機(jī)上發(fā)送了朋友圈通知 CircleNewPublishNotice=1031;
9祖娘、手機(jī)上刪除朋友圈返回通知CircleDelNotice =1032;
舉例
發(fā)送文本消息
請(qǐng)求URL:
請(qǐng)求方式:
POST
請(qǐng)求頭Headers:
Content-Type:application/json
Authorization:login接口返回
參數(shù):
參數(shù)名 必選 類(lèi)型 說(shuō)明
wId 是 string 登錄實(shí)例標(biāo)識(shí)
wcId 是 string 接收人微信id/群id
content 是 string 文本內(nèi)容消息
返回?cái)?shù)據(jù):
參數(shù)名 類(lèi)型 說(shuō)明
code string 1000成功,1001失敗
msg string 反饋信息
data
data.type int 類(lèi)型
data.msgId long 消息msgId
data.newMsgId long 消息newMsgId
data.createTime long 消息發(fā)送時(shí)間戳
data.wcId string 消息接收方id
請(qǐng)求參數(shù)示例
{
? ? "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
? ? "wcId": "azhichao",
? ? "content": "天行健啊奄,君子以自強(qiáng)不息"
}
成功返回示例
{
? ? "code": "1000",
? ? "message": "處理成功",
? ? "data": {
? ? ? ? "type": 1,
? ? ? ? "msgId": 2562652205,
? ? ? ? "newMsgId": 4482117376572170921,
? ? ? ? "createTime": 1641457769,
? ? ? ? "wcId": "azhichao"
? ? }
}
錯(cuò)誤返回示例
{
? ? "message": "失敗",
? ? "code": "1001",
? ? "data": null
}