個(gè)人微信開發(fā)API協(xié)議
一、基礎(chǔ)消息類型
1、客戶端發(fā)送的心跳包HeartBeatReq=1001;
2、消息接收確認(rèn)回復(fù)(接收或拒絕接收)MsgReceivedAck =1002;
3、錯(cuò)誤單獨(dú)提升為一種消息類型 Error = 1003;
4、通用任務(wù)執(zhí)行結(jié)果通知TaskResultNotice=1025;
二、設(shè)備客戶端授權(quán)類消息
1、設(shè)備(手機(jī)客戶端、客服客戶端)獲取通信token請(qǐng)求與響應(yīng)
DeviceAuthReq=1010;
設(shè)備(手機(jī)客戶端、客服客戶端)獲取通信 token 響應(yīng) DeviceAuthRsp =1011;
2、設(shè)備授權(quán)后退出(僅用于服務(wù)端內(nèi)部)DeviceExitNotice = 1012;
3、賬號(hào)強(qiáng)制下線通知AccountForceOfflineNotice =1013;
三、手機(jī)客戶端上傳的通知類消息
1、手機(jī)客戶端微信上線通知WeChatOnlineNotice = 1020;
2、手機(jī)客戶端微信下線通知WeChatOfflineNotice =1021;
3、微信個(gè)人號(hào)新增好友通知FriendAddNotice =1022;
4、微信個(gè)人號(hào)移除好友通知FriendDelNotice =1023;
5、微信好友發(fā)來聊天消息通知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ù)名 必選 類型 說明
wId 是 string 登錄實(shí)例標(biāo)識(shí)
wcId 是 string 接收人微信id/群id
content 是 string 文本內(nèi)容消息
返回?cái)?shù)據(jù)：
參數(shù)名 類型 說明
code string 1000成功，1001失敗
msg string 反饋信息
data
data.type int 類型
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
}
