よくある質問
問題が起きたら、リクエストの時刻、HTTP ステータス、request_id を控えてください。スクリーンショットやログを共有する前にキーを隠してください。
リクエストは成功したのに通知が表示されない#
200 は Apple または Google が通知を受け付けたことを示し、端末に表示されたことまでは保証しません。次の順に確認してください。
- アプリのリンクとスクリプトのリンクが一致している。リンクをリセットするとキーが変わります。
- システム設定で Breeze の通知が許可されている。
- 集中モードやおやすみモードで隠れていない。
level=timeSensitiveを試すか、Breeze の集中モードフィルタを確認してください。 - 「設定 → ミュート中のグループ」でグループがミュートされていない。
- Android では、そのレベルの Breeze 通知チャンネルがオンで、電池の最適化でアプリが制限されていない。
通知が履歴にはあるのにバナーが出ない場合、原因は配信ではなくシステムの設定です。
404 が返る#
キーが存在しないか、無効になっています。リンクのリセット、アプリの再インストール、リンクの一部だけをコピーした場合に起こります。アプリから現在のリンクをコピーし、スクリプトを更新してください。
422 が返る#
送信先の端末が対応していないパラメーターがあります。よくある原因は critical(未対応)と、Android での badge、ciphertext、カスタムサウンド、sound=none です。レスポンスの error に原因が示されます。そのパラメーターを外すか、パラメーターのプラットフォーム列を確認してください。
429 が返る#
短時間にリクエストを送りすぎています。Retry-After の秒数だけ待ってから再試行してください。制限はキーごと・公開 IP ごとに数えるため、同じオフィスや家庭のネットワークの端末は枠を共有します。現在の制限は API リファレンスをご覧ください。
同じ通知が 2 回届いた#
タイムアウトや接続の切断は、Apple や Google が通知を受け付けた後に起きることがあり、再試行すると再度表示されます。タイムアウト後に自動で再試行しないでください。207 の後にグループ全体へ再送するのも避けてください。通知に id を付けておけば、再試行しても 2 件目が増えず 1 件目が置き換わります。
画像やサウンドが読み込まれない#
画像、アイコン、リモートのサウンドは HTTPS で、10 秒以内にダウンロードできる必要があります。リモートのサウンドは最大 6 MB の .caf ファイルに限ります。カスタムサウンドの名前は「設定 → サウンド」に表示される名前と一致させてください。
リンクが他人に知られた#
アプリでリンクをリセットしてください。古いキーは次のリクエストから無効になります。その後、古いリンクを使っていたスクリプトやツールをすべて更新します。キーでできるのは送信だけなので、履歴を読まれることはありません。
既存の Bark スクリプトは使える?#
ほとんど使えます。ホストとキーを Breeze のリンクに差し替えてください。パスの形式、device_key を使う /push、Bark のパラメーター名はすべて動きます。
自分のサーバーで動かせる?#
できません。Breeze は push.breezelabs.dev のホスト型サービスとして提供しているので、アプリは設定なしで使えます。サービスに内容を見せたくない場合は暗号化を使ってください。
Android でも使える?#
使えます。Android でも同じリンクとほとんどのパラメーターを使えます。暗号化、カスタムサウンド、バッジ、重大な通知は現在 iPhone のみです。
重大な通知は使える?#
まだ使えません。Apple の許可が必要です。それまでは level=timeSensitive と call=1 を組み合わせてください。サウンドと通知レベルをご覧ください。
サービスは稼働している?#
サービス状況のページで、サービス本体と Apple・Google への接続を確認できます。