從資料庫永久刪除由 id
指定的記錄,並通知已訂閱的 sockets。
DELETE /:model/:id
這會摧毀符合 id 參數的記錄,並以 JSON 字典形式回應,代表被摧毀的實例。如果沒有符合指定 id 的模型實例存在,則會傳回 404
錯誤。
此外,destroy
事件將會發布到所有訂閱記錄室的 sockets,且目前訂閱該記錄的所有 sockets 將會取消訂閱。
參數 | 類型 | 詳細資訊 |
---|---|---|
model | 包含模型的 identity。 例如: 'purchase' (在 /purchase/7 中) |
|
id (必填) |
要摧毀的記錄的主鍵值,在路徑中指定。 例如: '7' (在 /purchase/7 中)。 |
刪除 Pinkie Pie
DELETE /user/4
{
"name": "Pinkie Pie",
"hobby": "kickin",
"id": 4,
"createdAt": 1485550644076,
"updatedAt": 1485550644076
}
如果您的應用程式已啟用 WebSockets,則每個訂閱被摧毀記錄的客戶端都將收到通知,其中事件名稱是模型 identity (例如 user
),且「message」具有以下格式
verb: 'destroyed',
id: <the record primary key>,
previous: <a dictionary of the attribute values of the destroyed record (including populated associations)>
例如,繼續上面的範例,所有訂閱 User
#4 的客戶端 (除了發出請求的客戶端) 都可能會收到以下訊息
id: 4,
verb: 'destroyed',
previous: {
name: 'Pinkie Pie',
hobby: 'kickin',
createdAt: 1485550644076,
updatedAt: 1485550644076
}
如果被摧毀的記錄有任何與其他記錄的連結,則可能會有一些額外的通知
假設在我們的範例中被摧毀的記錄與 via
有關聯,那麼 updated
或 removedFrom
通知也將發送到任何訂閱關係另一側的那些子記錄的客戶端。請參閱 藍圖 > 從...移除 和 藍圖 > 更新 以取得有關這些通知結構的更多資訊。
如果
via
指向的關聯是複數 (例如cashiers
),則將發送removedFrom
通知。否則,如果via
指向單數關聯 (例如cashier
),則將發送updated
通知。