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

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

--- 帮我吧文档:客户端sdk手册:传输文件接口 [2021/02/23 12:00]
admin 移除
+++ — (当前版本)
@@ 行 1: / 行 1: @@
-==== 传输文件接口 ====
-传输文件接口用于发送文件到对端ID的客户端，具体接口如下：\\
-**请求地址：**
-<WRAP prewrap>
-  http://127.0.0.1:xxxx/apiSendFile?RemoteID={RemoteID}&SessionKey={SessionKey}&FileName={FileName}
-</WRAP>
-**请求方式：** 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数据包给开发者：
-<code>
-{
-     "errorcode" : 0,
-     "message" : "success",
-}
-</code>
-^  JSON字段  ^  说明  ^
-| errorcode  | 应答结果码：\\ 0: 成功\\ 2: Remote格式错误\\ 3: 没有找到该文件  |
-| message  | 出错消息，可以用于获取进一步的出错原因（该字段在所有应答消息中都有）  |