删除 API

本文档介绍如何使用 API 删除表格中的记录。

接口说明

删除表格中的指定记录。

请求方法

DELETE /api/bases/{base_id}/tables/{table_name}/records/{record_id}

路径参数

参数	类型	描述
base_id	string	数据库 ID
table_name	string	表格名称
record_id	string	记录 ID

请求头

x-bm-token: your_api_token

示例请求

删除单条记录

DELETE /api/bases/base123/tables/table456/records/rec789

响应格式

成功响应

{
  "id": "11",
  "name": "删除的记录",
  "created_by": "usrIL1t20OwVvW9jXzT",
  "updated_by": "usrIL1t20OwVvW9jXzT",
  "created_at": "2024-11-20T17:30:12.000Z",
  "updated_at": "2024-11-20T17:30:27.000Z",
  "creator": {
    "id": "usrIL1t20OwVvW9jXzT",
    "email": "[email protected]",
    "name": "Dylan"
  },
  "modifier": {
    "id": "usrIL1t20OwVvW9jXzT",
    "email": "[email protected]",
    "name": "Dylan"
  }
}

错误响应

{
  "message": "Record not found"
}

注意事项

1. 删除记录是不可逆操作，请谨慎使用
2. 如果记录不存在，将返回 404 错误
3. 删除记录可能会影响其他表中的关联字段