帮我吧文档:客户端sdk手册:传输文件接口

传输文件接口

传输文件接口用于发送文件到对端ID的客户端,具体接口如下:
请求地址:

http://127.0.0.1:xxxx/apiSendFile?RemoteID={RemoteID}&SessionKey={SessionKey}&FileName={FileName}

请求方式: GET
参数说明:

参数 是否必须 说明
SessionKey 通过认证接口获取的会话密钥,如果没有Bangwo8APIServer.conf或者Bangwo8APIServer.conf中ServerSecureKey为空,则表明访问无需秘钥保护,此时不需要此字段
RemoteID 被远程控制的对端的9位数字的帮我吧ID
FileName 需要被发送文件的全路径,需要BaseEncode64

接收自定义消息说明: 当对端接收到消息时,帮我吧会发送一个COPYDATA消息,COPYDATASTRUCT的dwData为用户指定的自定义消息类型,如果没有指定则默认为WM_MSG_BANGWO8_API(WM_USER + 4500),lpData值为真正发送的数据,数据格式为json,格式为{“cmd”:“transfile”,“remote”:“”,“filename”:“filename”,“length=“filesize”,”“transfer”:“position”,“state”:“state”},length为整个文件字节大小,transfer为当前文件传输完成数据的位置,state为传输状态,{ 0 未知状态;1 开始传输文件,需要等待对端接受;2 用户接收;3 用户拒绝;4 用户取消;5 传输完成;6 传输失败}

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

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

页面工具