帮我吧文档:客户端sdk手册:聊天接口

聊天接口

聊天接口用于发送消息或者图片给某个ID的客户端,具体接口如下:
请求地址:

http://127.0.0.1:xxxx/apiSendChatMsg?RemoteID={RemoteID}&Message={Message}&Image={Image}&Shake={Shake}

请求方式: GET
参数说明:

参数 是否必须 说明
SessionKey 通过认证接口获取的会话密钥,如果没有Bangwo8APIServer.conf或者Bangwo8APIServer.conf中ServerSecureKey为空,则表明访问无需秘钥保护,此时不需要此字段
RemoteID 被远程控制的对端的9位数字的帮我吧ID
Message 发送给对端的消息内容,需要Base64Encode
Image 发送给对端的图片,内容为图片的全路径,需要Base64Encode
Shake 给对端发送一个抖动消息,内容不为空就可以了

注意:Message、Image、Shake每次只能传一个,每条发送的消息只能有这三种的其中一种
接收自定义消息说明: 当对端接收到消息时,帮我吧会发送一个COPYDATA消息,COPYDATASTRUCT的dwData为用户指定的自定义消息类型,如果没有指定则默认为WM_MSG_BANGWO8_API(WM_USER + 4500),lpData值为真正发送的数据,数据格式为json,{“cmd”:“chat”, “remoteid”:“xxxxx”,“message”:“message”,“image”:“image”,“shake”:“shake”},message为消息内容,image为图片全路径,shake为窗口抖动消息。

返回值说明:
正常情况下,本接口会返回下述JSON数据包给开发者:

{
     "errorcode" : 0,
     "message" : "success",
}
JSON字段 说明
errorcode 应答结果码:
0: 成功
2: Remote格式错误
message 出错消息,可以用于获取进一步的出错原因(该字段在所有应答消息中都有)

页面工具