本功能处于开发与测试状态,会随时重启、更新、调试或断开。
概述
长连接是指在 Quicker 软件与服务器之间建立一条持续存在的网络连接。有了这条连接之后,Quicker 服务端可以主动将信息推送给电脑。
本服务将在较长时期内以“试运行”方式提供,期待稳定性能够经受住考验😁。
本服务连接全程使用 SSL/HTTPS 传输,所以理论上还是比较安全的。
目前所有数据无存储。未来可能提供选项是否将某些推送数据保存起来以备某些情况下使用。
关于专业版和免费版:
CL一方面希望希望能给更多的人提供方便,另一方面也希望更多的人付费来支持Quicker的长期开发和运营。因此长连接功能是否给免费用户提供,是一个有点矛盾的问题。目前暂定的方案如下,CL保留随时根据需要进行调整的权力。
- 免费版用户:
- 支持使用 GET 请求发送 copy 和 paste 操作,不支持发送 action 操作(执行动作)。
- 不支持 Post 请求。
- 专业版用户:
- 支持所有操作类型;
- 支持 POST 请求,最大支持 100KB 大小;
设置
设置推送验证码
验证码用于避免其他人将信息推送到你的电脑或获取你的连接信息,请务必保证安全。
在 Quicker 网站用户中心页面中,点击“个人设置”(点此链接直达)。在此页面中设置推送验证码。
验证码为空时,不接受推送信息。
点击“随机生成”可以自动生成一串密码。
点击“复制”可以将密码复制到剪贴板。
连接到推送服务
使用 1.5.2+ 版本的 Quicker 客户端软件。点击“用户”图标,在菜单中选择“连接到推送服务”。
连接成功后,图标显示一个绿点:
这时候就可以通过网络接口向客户端推送数据了。
接口说明
推送内容到电脑
将内容推送到Windows。
使用 GET 方式调用
https://push.getquicker.net/push?toUser=自己的帐号email&code=推送验证码&operation=操作类型&data=经过URL编码的数据
除了 data 以外,其他各参数值如果包含特殊字符,也应使用 URL 编码处理一下。在编码处理比较方便的情况下,应该对每个参数的值都做 URL 编码处理。
参数说明
【toUser】自己的帐号 Email 地址。
【code】推送验证码,为本文开始部分所说明的网页中设置的验证码。
【operation】操作类型,支持如下的值:
- copy 将内容复制到剪贴板
- paste 将内容粘贴到当前窗口
- action 执行动作,此时:
- 网址中需附加action参数:.....&action=动作ID或动作名&... (使用动作名时,需保证没有重名的动作)。
- data数据内容将作为动作的输入参数传递。【仅专业版支持】
【data】经过 URL 编码的文本内容。请注意不要太长,否则可能导致构建的网址太长从而使http请求失败。
可选参数
【toDevice】要发送给的设备名。
- 如果不指定或指定为*,则发送给“活动”客户端(通常为最后连接的客户端)。
- 指定主机名,则发送给此设备。(可在命令行窗口中运行 hostname 查看当前计算机的主机名)
- 指定“!主机名”(英文半角叹号加设备名,不包含引号),发送给除此设备以外的其他设备。
【action】当 operation 参数为“action”时,使用本参数指定要执行动作的 ID 或名称。
返回数据格式
返回Json格式的数据:
{ "successCount": 1, "errorMessage": "" }
【successCount】成功发送给的客户端数量。0表示失败。
【errorMessage】发送失败时错误消息的内容。
使用Post方式调用
接口网址:https://push.getquicker.net/push
接口参数:Post 请求体以 json 格式传递参数。
参数内容同Get请求。示例:
{ "toUser":"youremail@domain.com", "code":"XsfFYC6Q48ib", "data":"Hello Quicker!Quicker真好玩!哈哈😄", "operation":"paste" }
获得已连接的设备
使用 Get 方式调用:
https://push.getquicker.net/helpers/getdevices?user=自己的帐号email&code=推送验证码
返回结果:
{ "count": 1, //设备数量 "devices": [ { "name": "DESKTOP-123456", //电脑主机名 "isActive": true, //是否活动主机(如果同时有多个电脑连接,其中会有一个是活动主机) "ip": "111.116.181.33" // 主机的公网IP } ], "isSuccess": true, "message": null }
多客户端使用同一个帐号连接
当多个客户端使用同一个帐号连接时,只有一个客户端可以处于“活动”状态。推送的内容将默认发送到“活动”客户端。
活动状态的客户端用户图标右下角的点为绿色。
非活动客户端用户图标右下角的点为灰色。
后连接的客户端会自动变为“活动”客户端。
如果希望将非活动客户端转变为活动客户端,可以点击“设为活动客户端”菜单。
同步通知
使用同一帐号的设备都连接到推送服务器之后,当一个电脑上修改配置后,将会在30-60秒之后通知其他电脑进行同步。
示例
- IOS 快捷指令:将剪贴板或选择的文本发送到电脑。安装后请设置Email和验证码。然后复制内容后运行快捷指令(某些软件中选中文本后分享可以选此快捷指令)。https://www.icloud.com/shortcuts/140460b404404463bbe54e6f24e0d43d