トピックの購読解除
トピックの購読を止めることで、プッシュ通知を止めることができます。
ここではユーザースコープのトピックの購読を解除する例を挙げます。グループスコープ、ユーザースコープも同様です(URL は トピックの購読 を参考にしてください)。
curl -v -X DELETE \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
"https://api-jp.kii.com/api/apps/{APP_ID}/topics/{TOPIC_NAME}/push/subscriptions/users/{TARGET_USER_ID}"
{APP_ID}
をアプリの値に、TARGET_USER_ID
を対象ユーザーの ID に置き換えてください。また {ACCESS_TOKEN}
は、このユーザーのトークンかアプリ管理者トークンである必要があります。グループスコープおよびユーザースコープのトピックの購読を解除する場合は、適宜ベース URL を変えてください(ベース URI の詳細については ユーザープッシュ通知 (Push to User) を参照してください)。
Kii Cloud は以下の応答を返します。
- 購読解除に成功した場合は、200 応答を返します。
- 指定したトピックが存在しない場合は、エラーコード
TOPIC_NOT_FOUND
を 404 応答で返します。 - ユーザーがトピックを購読していない場合は、エラーコード
PUSH_SUBSCRIPTION_NOT_FOUND
を 404 応答で返します。