Bark 推送技能用于把消息推送到 iOS 设备的 Bark 应用中。Bark 是 iOS 上的推送通知工具,免费、简单、安全,基于 APNs,不耗电,支持自建服务器和加密推送。
用途:当用户有重要事项需要通知、明确要求用 Bark 推送,或需要向 iOS 设备发送推送通知时使用本技能。
使用前提:用户已在 iOS 设备安装 Bark App,并已获取用户的 Bark Key(打开 App 后复制测试 URL 中的 key)。
主要能力与使用方式: 基础推送通过 GET 请求完成,支持三种路径形式:https://api.day.app/{key}/{body}、https://api.day.app/{key}/{title}/{body}、https://api.day.app/{key}/{title}/{subtitle}/{body}。参数中 key 为用户的 Bark Key,title 为推送标题(比 body 稍大),subtitle 为推送副标题,body 为推送内容,换行使用 \n。也可使用 POST 请求,参数名与路径参数相同。
高级功能包括:点击跳转 URL(https://api.day.app/{key}/url?url=https://www.example.com)、消息分组(https://api.day.app/{key}/group?group=groupName)、自定义图标(iOS 15+,https://api.day.app/{key}/icon?icon=http://example.com/avatar.jpg)、自定义声音(https://api.day.app/{key}/sound?sound=alarm)、循环播放声音 30 秒的来电模式(https://api.day.app/{key}/call?call=1)、加密推送(https://api.day.app/{key}/ciphertext?ciphertext=加密内容)。
时效性通知通过 level 参数设置:active 为默认值,立即亮屏显示;timeSensitive 为时效性通知,专注模式下也可显示;passive 仅添加到通知列表,不亮屏。示例:https://api.day.app/{key}/title?level=timeSensitive。紧急警报使用 level=critical,可忽略静音和勿扰模式,始终播放声音并显示通知。
脚本方式:资料提供一个 Bash 推送脚本 bark_push.sh,接收 KEY、TITLE、BODY 三个参数,使用 python3 对标题和正文进行 URL 编码后通过 curl 调用推送接口。使用示例包括:./bark_push.sh "your-key" "标题" "内容"、curl "https://api.day.app/your-key/url?url=https://example.com"、curl "https://api.day.app/your-key/提醒?level=timeSensitive"。
适用场景:重要事项通知、定时或自动化提醒、需要跳转链接或分组管理的通知、需要时效性或紧急提醒的通知。
限制与注意事项:首次使用需要获取用户的 Bark Key;时效性通知和紧急警报需要用户在 iOS 设置中授权;自建服务器用户需将 api.day.app 替换为自建服务器地址;推送内容建议进行 URL 编码处理特殊字符。