トピックの購読解除

トピックの購読を止めることで、プッシュ通知を止めることができます。

ここではユーザースコープのトピックの購読を解除する例を挙げます。グループスコープ、ユーザースコープも同様です(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 応答で返します。