事件

事件记录库生命周期与表、字段结构变化，不记录行读写。

默认按 seq 升序；只给 before_seq 时默认按 desc（最新在前）。next_cursor 是不透明的字符串游标，原样传回：asc 时传给 after_seq，desc 时传给 before_seq。两个游标同时提供，或 before_seq 与 order=asc 同时提供，返回 400 INVALID_PARAMS。删除中的库仍可读取事件。

next_cursor 是不透明的字符串游标，原样传回，不要对它做运算；为 null 表示没有后续页。下方响应为省略 order 的升序实测结果。倒序翻页按以下请求使用；该扩展的线上响应将在服务更新后补充。

# 最新一页
curl "https://api.deepraxis.ai/database/v1/databases/${DATABASE_ID}/events?order=desc&limit=10" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"

# 把 NEXT_CURSOR 设为上一页返回的 next_cursor
curl "https://api.deepraxis.ai/database/v1/databases/${DATABASE_ID}/events?order=desc&before_seq=${NEXT_CURSOR}&limit=10" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"

读取事件

GET /database/v1/databases/{database_id}/events

参数	位置	说明
database_id	path	库 ID。
after_seq	query	order=asc 时，只取 seq 大于该值的事件；不可同时提供 before_seq。
limit	query	最多返回的条数。 (default: 50) (1–200)
order	query	asc 按 seq 升序，desc 为最新在前。默认 asc；只给 before_seq 时默认 desc。
before_seq	query	只取 seq 小于该值的事件，最新在前；省略 order 时按 desc。不可同时提供 after_seq 或 order=asc。

返回: Page + object.

响应

HTTP 200

Success

application/json

名称	类型	说明
data	array<object>	Events on this page in the requested order (ascending seq by default, newest first with before_seq or order=desc).
data[].seq	integer	Position of the event in the database's event log; starts at 1 and strictly increases. Use it as after_seq or before_seq to page.
data[].id	string	Unique identifier of this event record.
data[].type	string	What happened: a lifecycle transition of the database, or a schema change to a table or field.
data[].processed_at	string	Time the event was recorded, as an RFC 3339 UTC timestamp.
data[].database_id	string	Id (db_…) of the database the event belongs to.
data[].table_id	string	Id (tbl_…) of the affected table; present only for table and field events.
data[].field_id	string	Id (fld_…) of the affected field; present only for field events.
next_cursor	string \| null	Opaque cursor for the next page, or null when there are no more items. Databases list: pass it as cursor. Events list: pass it as after_seq (order asc) or before_seq (order desc).

curl -X GET "https://api.deepraxis.ai/database/v1/databases/${DATABASE_ID}/events?after_seq=0&limit=10" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"

响应示例 — HTTP 200

{
  "data": [
    {
      "seq": 1,
      "id": "7390d75e-216c-4799-891e-c043bac8bce5",
      "type": "database.status_provisioning",
      "processed_at": "2026-10-11T17:41:41.339Z",
      "database_id": "db_d6f0d743d5a645e8"
    },
    {
      "seq": 2,
      "id": "39db0ef4-99b4-4846-9d50-9998e25cf48f",
      "type": "database.status_active",
      "processed_at": "2026-10-11T17:41:41.339Z",
      "database_id": "db_d6f0d743d5a645e8"
    },
    {
      "seq": 3,
      "id": "d295651d-5e83-4b42-bcd3-c979fb71f375",
      "type": "table.created",
      "processed_at": "2026-10-11T17:41:44.246Z",
      "database_id": "db_d6f0d743d5a645e8",
      "table_id": "tbl_2b3431c772754599"
    },
    {
      "seq": 4,
      "id": "eb255753-3dd7-4eae-8861-d53408bfcaf4",
      "type": "table.updated",
      "processed_at": "2026-10-11T17:41:45.127Z",
      "database_id": "db_d6f0d743d5a645e8",
      "table_id": "tbl_2b3431c772754599"
    },
    {
      "seq": 5,
      "id": "99c86e22-0629-4391-85e5-d7b8b31de833",
      "type": "field.added",
      "processed_at": "2026-10-11T17:41:45.420Z",
      "database_id": "db_d6f0d743d5a645e8",
      "table_id": "tbl_2b3431c772754599",
      "field_id": "fld_4c3e63869e35458c"
    },
    {
      "seq": 6,
      "id": "a9b85950-363d-4ab3-8c85-6228eec3d099",
      "type": "field.updated",
      "processed_at": "2026-10-11T17:41:46.276Z",
      "database_id": "db_d6f0d743d5a645e8",
      "table_id": "tbl_2b3431c772754599",
      "field_id": "fld_4c3e63869e35458c"
    },
    {
      "seq": 7,
      "id": "73ca124f-6cbb-4a43-8a37-4ff50a211dd5",
      "type": "field.deleted",
      "processed_at": "2026-10-11T17:41:47.136Z",
      "database_id": "db_d6f0d743d5a645e8",
      "table_id": "tbl_2b3431c772754599",
      "field_id": "fld_4c3e63869e35458c"
    }
  ],
  "next_cursor": null
}

DatabaseEvent

字段	类型	必填	说明
seq	integer	是	库内递增序号
id	string	是	资源 ID
type	"database.status_provisioning" / "database.status_active" / "database.status_deleting" / "database.status_deleted" / "database.status_failed" / "database.restored" / "table.created" / "table.updated" / "table.deleted" / "field.added" / "field.updated" / "field.deleted"	是	类型
processed_at	date-time	是	事件时间
database_id	string	是	库 ID
table_id	string	否	相关表 ID（可选）
field_id	string	否	相关字段 ID（可选）

事件

读取事件

响应

HTTP 200

DatabaseEvent

本页内容