推送到电脑(V2 版本)

适用于Quicker 1.23.0+版本。

在Quicker和服务器之间建立一条持续存在的链接,从而在需要的时候,可以将信息从其他设备推送给运行Quicker的电脑。


相对于V1版本的长连接功能,主要变更的内容如下:

  1. 推送接口地址修改为 https://push.getquicker.cn/to/quicker 。
  2. 长连接协议修改为Websocket。
  3. 增加等待返回结果的功能。
  4. 新版Quicker和新版推送接口需要配合使用。
  5. 最大推送请求长度为30KB。
  6. 增加自动重连等机制,改善稳定性。
  7. 免费版的限制:
    1. 不支持运行quicker动作。
    2. 不支持等待响应结果。
    3. 同时只能一台电脑连接。



设置

Quicker连接到推送服务

此功能默认为关闭状态。请从菜单中开启连接:

image.png


正常连接后,将在头像按钮右下角和菜单中显示连接状态。

image.png


设置推送验证码

从菜单中可以快速打开会员中心的推送设置网页。

image.png

在会员中心网页中设置推送验证码。

image.png


使用推送小工具

连接建立、设置好验证码以后,就可以简单体验一下用手机发送文字到窗口了(使用手机上提供的语音输入方式)。

用微信或其它二维码工具扫码会员中心推送页面里的二维码即可打开一个移动端网页。



接口说明


推送内容到电脑



接口网址: https://push.getquicker.cn/to/quicker 


Post请求

接口参数:在请求体中以 json 格式传递参数


{
  "toUser":"youremail@domain.com",
  "code":"XsfFYC6Q48ib",
  "toDevice":"",
  "operation":"paste",
  "data":"Hello Quicker!Quicker真好玩!哈哈😄",
  "action":"动作名或ID",
  "wait":false,
  "maxWaitMs":5000,
  "txt":false
}


参数说明:


Get请求

https://push.getquicker.cn/to/quicker?toUser=帐号email`&code=推送验证码&toDevice=目标设备名(可选)&operation=操作类型(可选)&data=经过URL编码的数据(可选)&action=动作ID或名称(可选)&wait=是否等待(可选)&maxWaitMs=最长等待毫秒数(可选)&txt=是否返回纯文本结果(可选)


所有参数应当根据需要进行URL编码。



返回值

返回Json数据时,内容格式

{
    "isSuccess": true,
    "successCount": 1,
    "errorMessage": null,
    "timeCost": 219,
    "devices": {
        "DESKTOP-37OSSM2": "Ok."
    }
}


返回文本数据时:


如何从动作返回内容




多台电脑连接

当多个客户端使用同一个帐号连接时,只有一个客户端可以处于“活动”状态。推送的内容将默认发送到“活动”客户端。


活动状态的客户端用户图标右下角的点为绿色

image.png


非活动客户端用户图标右下角的点为灰色

image.png


后连接的客户端会自动变为“活动”客户端。


如果希望将非活动客户端转变为活动客户端,可以点击“设为活动客户端”菜单。

image.png



同步通知

使用同一帐号的设备都连接到推送服务器之后,当一个电脑上修改配置后,将会在30-60秒之后通知其他电脑进行同步。



示例工具




推送到Email

通过API调用,给自己的Quicker账号邮箱发送通知邮件。一般用于自动化场景下给自己发送通知。


💡 限专业版。

💡 微信登录的用户请先在网页里绑定个人邮箱。

💡 为避免垃圾邮件,仅支持给自己的Quicker账号绑定的Email地址发送邮件。

💡 邮件发送需要一定的时间。


接口说明


接口网址: https://push.getquicker.cn/to/email 


Get请求

各参数需要进行URL编码。

https://push.getquicker.cn/to/email?toUser=账号邮箱&code=推送验证码&subject=邮件标题&plainBody=纯文本邮件内容&htmlBody=Html格式的邮件内容 


Post请求

接口参数:在请求体中以 json 格式传递参数


{
  "toUser":"youremail@domain.com",
  "code":"XsfFYC6Q48ib",
  "subject":"邮件标题",
  "plainBody":"纯文本格式的邮件消息内容。",
  "htmlBody":"HTML格式的邮件消息内容。"
}


返回结果

{
    "isSuccess": true,
    "message": "ok"
}


参考动作:将选中内容发送给自己的Email