Webhookの削除
Webhookの削除
Webhookは、開発者コンソールまたはAPIを使用して削除できます。
開発者コンソール
Webhookを削除するには、以下の手順に従います。
- 開発者コンソールで、[Webhook] タブに移動します。
- WebhookのIDをクリックして、削除するWebhookを選択します。
- [削除] ボタンをクリックします。
- 警告メッセージの下に表示される [削除] をクリックして、操作を確定します。
API
ファイルやフォルダからWebhookを削除するには、WebhookのIDを指定してWebhookを削除エンドポイントを使用する必要があります。この値は、すべてのWebhookのリストを取得エンドポイントを使用して取得できます。
cURL
curl -i -X DELETE "https://api.box.com/2.0/webhooks/3321123" \
-H "Authorization: Bearer <ACCESS_TOKEN>"
.NET
await client.WebhooksManager.DeleteWebhookAsync("11111");
Python
client.webhook(webhook_id='12345').delete()
print('The webhook was successfully deleted!')
Node
client.webhooks.delete('1234')
.then(() => {
// deletion succeeded — no value returned
});
iOS
client.webhooks.delete(webhookId: "22222") { result: Result<Void, BoxSDKError>} in
guard case .success = result else {
print("Error deleting webhook")
return
}
print("Webhook successfully deleted")
}
その他の削除の理由
このエンドポイントを使用していなくても、Webhookが削除される場合があります。
Webhookは以下の理由で削除される可能性があります。
- Boxアプリケーションを削除すると、そのアプリケーションに関連付けられているすべてのWebhookが自動的に削除されます。
- Webhookに関連付けられているアクティブなアクセストークンをすべて削除すると、そのWebhookが自動的に削除されます。これには、開発者トークンとパスワードが含まれます。
- 最後に成功した配信から30日が経過し、最後に配信が成功した日から最後のトリガーの日付までの期間が14日を超えた場合、Webhookは自動的に削除されます。
これらのすべてのケースで、BoxはWEBHOOK.DELETED
というイベント名を含むWebhookペイロードを通知URLに送信します。ペイロードの本文には以下の追加情報が含まれます。
"additional_info": {
"reason": "auto_cleanup"
}