appstore-1panel/apps/bark
Meng Sen 0555c9b2a6 应用标准化
Signed-off-by: Meng Sen <qyg2297248353@gmail.com>
2024-11-27 18:26:48 +08:00
..
2.1.5 应用标准化 2024-11-27 18:26:48 +08:00
data.yml 修复 应用标准格式 2024-09-10 12:13:37 +08:00
logo.png 提交合并 2024-07-17 16:30:13 +08:00
README.md 更新说明 2024-08-02 18:36:28 +08:00

Bark

一款注重隐私、安全可控的自定义通知推送工具。

Bark

特性

  • 免费、轻量简单调用接口即可给自己的iPhone发送推送。
  • 依赖苹果APNs及时、稳定、可靠
  • 不会消耗设备的电量, 基于系统推送服务与推送扩展APP本体并不需要运行。
  • 隐私安全,可以通过一些方式确保包含作者本人在内的所有人都无法窃取你的隐私。

安装说明

数据库链接 配置

MySQL DSN 数据库链接

格式:

user:pass@tcp(host)/dbname

# 例如
root:123456@tcp(127.0.0.1:3306)/bark

参数说明

参数 说明
user 数据库用户名
pass 数据库密码
host 数据库地址
dbname 数据库名称

使用其他端口时 host 格式为 host:port

URL格式

URL由推送key、参数 title、参数 body 组成。有下面两种组合方式

服务基础验证

可选项,验证方式为 Basic,具体格式为 Basic base64(username:password),其中 base64(username:password)username:passwordbase64 编码结果。

  • 用户名 (服务基础验证)
  • 密码 (服务基础验证)
/:key/:body 
/:key/:title/:body 

请求方式

GET 请求参数拼接在 URL 后面,例如:
curl https://api.day.app/your_key/推送内容?group=分组&copy=复制

手动拼接参数到URL上时请注意URL编码问题可以参考阅读常见问题URL编码

POST 请求参数放在请求体中,例如:
curl -X POST https://api.day.app/your_key \
     -d'body=推送内容&group=分组&copy=复制'
POST 请求支持JSON例如
curl -X "POST" "https://api.day.app/your_key" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "body": "Test Bark Server",
  "title": "Test Title",
  "badge": 1,
  "category": "myNotificationCategory",
  "sound": "minuet.caf",
  "icon": "https://day.app/assets/images/avatar.jpg",
  "group": "test",
  "url": "https://mritd.com"
}'
JSON 请求 key 可以放进请求体中,URL 路径须为 /push例如
curl -X "POST" "https://api.day.app/push" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "body": "Test Bark Server",
  "title": "Test Title",
  "device_key": "your_key"
}'

请求参数

支持的参数列表具体效果可在APP内预览。

参数 说明
title 推送标题
body 推送内容
level 推送中断级别。 active默认值系统会立即亮屏显示通知 timeSensitive时效性通知可在专注状态下显示通知。 passive仅将通知添加到通知列表不会亮屏提醒。
badge 推送角标,可以是任意数字
autoCopy iOS14.5以下自动复制推送内容iOS14.5以上需手动长按推送或下拉推送
copy 复制推送时,指定复制的内容,不传此参数将复制整个推送内容。
sound 可以为推送设置不同的铃声
icon 为推送设置自定义图标设置的图标将替换默认Bark图标。 图标会自动缓存在本机,相同的图标 URL 仅下载一次。
group 对消息进行分组推送将按group分组显示在通知中心中。 也可在历史消息列表中选择查看不同的群组。
isArchive 传 1 保存推送传其他的不保存推送不传按APP内设置来决定是否保存。
url 点击推送时跳转的URL 支持URL Scheme 和 Universal Link

Ms Studio