一個(gè) API其實(shí)是一整套接口體系。按功能離發(fā)消息這個(gè)核心的遠(yuǎn)近畫成三個(gè)圈盤點(diǎn)起來(lái)最直觀。一、核心圈——消息收發(fā)能力最核心的一圈圍繞消息sendText 發(fā)文本sendImage 發(fā)圖片sendFile 發(fā)文件以及視頻、語(yǔ)音、鏈接、名片、小程序等消息類型。收消息靠 Webhook 回調(diào)消息記錄接口查歷史。核心圈解決程序和微信能對(duì)話。90% 的機(jī)器人項(xiàng)目只用核心圈的能力就夠了。這一圈的接口調(diào)用最頻繁返回碼判斷1000 成功、1004 限頻也要最熟練。二、擴(kuò)展圈——人和群的管理能力往外一圈圍繞關(guān)系好友操作添加、通過(guò)、刪除、備注、聯(lián)系人同步群操作建群、拉人、踢人、群信息好友事件和群事件回調(diào)。擴(kuò)展圈解決程序能管理人?？头g迎、群運(yùn)營(yíng)、私域管理這類場(chǎng)景核心圈加上擴(kuò)展圈就完整了。這一圈有寫操作加人、踢人調(diào)用要謹(jǐn)慎。三、外圍圈——狀態(tài)與高級(jí)能力最外一圈圍繞監(jiān)控和進(jìn)階實(shí)例狀態(tài)回調(diào)在線、掉線、錯(cuò)誤碼體系、朋友圈相關(guān)能力、多媒體素材處理。外圍圈解決系統(tǒng)跑得穩(wěn)、玩得深。狀態(tài)監(jiān)控是生產(chǎn)環(huán)境必備——掉線不可怕不知道掉線才可怕。朋友圈等高級(jí)能力按業(yè)務(wù)需要選用。三圈能力盤點(diǎn)能力圈包含能力解決什么典型項(xiàng)目核心圈各類消息發(fā)送、回調(diào)接收、歷史記錄程序和微信對(duì)話聊天機(jī)器人、自動(dòng)回復(fù)擴(kuò)展圈好友管理、群管理、事件回調(diào)程序管理人私域運(yùn)營(yíng)、群管機(jī)器人外圍圈狀態(tài)監(jiān)控、錯(cuò)誤碼、朋友圈、素材處理跑穩(wěn)、玩深生產(chǎn)級(jí)系統(tǒng)、進(jìn)階應(yīng)用核心圈最小調(diào)用import requests def api(path, payload): r requests.post(fhttps://api.eyunz.com/v1/{path}, headers{Authorization: TOKEN}, json{wId: WID, **payload}) data r.json() if data.get(code) ! 1000: # 統(tǒng)一錯(cuò)誤處理 log_error(path, data) return data api(sendText, {toUser: to, content: 你好}) # 核心圈落地建議能力總覽見 Eyun 開發(fā)文檔。選能力時(shí)從核心圈起步跑通消息收發(fā)再往外加——項(xiàng)目上線初期核心圈就能驗(yàn)證 80% 的需求。外圍圈里唯一建議盡早接的是狀態(tài)監(jiān)控它不產(chǎn)生業(yè)務(wù)價(jià)值但能防止業(yè)務(wù)中斷。各接口參數(shù)在文檔中都有明確說(shuō)明實(shí)例開通見 Eyun 平臺(tái)。