
InsForge PostgreSQL 自动 API 生成快速上手建一张表得到全套 REST 接口【免费下载链接】InsForgeThe all-in-one, open-source backend platform for agentic coding. InsForge gives your coding agent database, auth, storage, compute, hosting, and AI gateway to ship full-stack apps end-to-end.项目地址: https://gitcode.com/GitHub_Trending/in/InsForge给项目多一张表往往要多写一套东西路由、鉴权、分页、错误处理外加客户端 SDK 的类型定义一天就没了。InsForge 的 PostgreSQL 自动 API 生成解决的就是这件事表一建好对应的 REST 端点随之就位后端代码一行不用写。下文讲这套映射是怎么工作的以及怎么把它用到生产环境。这是 InsForge 仪表板里的数据库表编辑器能看到带类型的列、行内编辑和 SQL 控制台。像图中这样建好一张表后对应的接口就已经生成了。 先看效果建一张表得到全套接口传统后端里要让posts表的数据进出你要完成的是一串活环节传统做法用 InsForge定义表结构写 SQL同一段 SQLCRUD 接口逐个手写四条路由随表自动生成过滤、排序、分页用查询构造器自己实现内置查询参数鉴权与权限校验自己写中间件行级安全 RLSPostgres 原生机制数据库自己按策略决定用户能看到哪些行客户端 SDK手写类型生成类型安全 SDK在 InsForge 里你只需要这一段CREATE TABLE posts ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), title TEXT NOT NULL, content TEXT, published BOOLEAN DEFAULT false, created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW() );执行完下面这组端点就能调了GET /api/database/records/posts— 查文章列表支持过滤、排序、分页POST /api/database/records/posts— 新建文章PATCH /api/database/records/posts— 更新文章DELETE /api/database/records/posts— 删除文章POST /api/database/rpc/{函数名}— 调用你自己写的数据库函数表结构是唯一要写的源码其余都从它推导。这些端点不是凭空来的映射工作交给了一个开源组件。 拆开原理给数据库配了个前台接待员一张表是怎么知道怎么变成接口的幕后跑着一个PostgREST把 Postgres 数据库直接暴露成 REST API 的开源组件。它的角色像前台接待员先读一遍每张表的花名册——也就是 schema每张表有哪些列、各是什么类型HTTP 请求进来后它对照花名册把请求翻译成 SQL再把查询结果交回去。一次调用走的是这条链建表仪表板或迁移文件→ PostgREST 自动映射 schema → 产出 CRUD 端点 → 客户端用类型安全 SDK 调用关键是映射是动态的表上加一列接口里立即可用不用重启、不用重新生成什么。接口形态固定之后价值取决于你怎么用。 这套接口能做什么查询与过滤查询参数全部走 PostgREST 语法过滤、排序、分页不用写代码GET /api/database/records/posts?statuseq.publishedordercreatedAt.desclimit10常用算子eq相等、gt/gte大于、ilike.*john*不区分大小写模糊匹配、in.(active,pending)列表匹配、is.null判空再加select参数只取需要的列。增删改POST建记录请求体是 JSON 数组建一条也要包成数组PATCH按过滤条件更新比如?ideq.id只动一条DELETE同样按条件删避免误删全表权限保护每个请求都带JWT携带用户身份的签名令牌。数据库通过前面提到的行级安全策略逐行校验写一条只有作者能看自己的文章的策略REST 查询、SDK 调用、实时订阅就都受同一条规则约束应用层不用再各写一遍校验。图中是 InsForge 支持的多种登录方式它们最终都签发同一类 JWT 令牌供数据库接口做行级校验。跨端调用接口就是普通 HTTP任何语言都能直接调官方另外提供 TypeScript、Swift、Kotlin 三种 SDK查询条件和返回值都是强类型的。仓库里的examples/python-ml-experiment-tracker是个真实例子实验记录存在experiments和runs两张表里仪表板页面直接建立在自动生成的接口上。这个仪表板列出每次实验运行的超参数和指标所有读写都走表生成的 PostgreSQL 自动 API。例子说明接口够用了要上生产还有几件事值得提前做。 让这套 API 上生产表设计上有几个习惯能少踩坑主键用UUID并默认gen_random_uuid()并发写入不打架每张表带created_at/updated_at时间戳列排序和审计都靠它给常出现在where和order里的列加索引否则就是全表扫描RLS 策略的要点是先关后开先写最严格的默认策略再按角色放行策略里从 JWT 取用户身份用owner_id user_id这类条件做过滤别把校验留给应用层。数据量上来之后默认把分页和字段筛选用好limit加offset翻页响应头的X-Total-Count和Content-Range会告诉你总数和当前范围select只取列表页需要的列报文小、延迟低。⚡ 三步上手安装并关联在项目目录运行npx insforge/cli login登录再运行npx insforge/cli link --project-id your-project-id关联项目建表在仪表板表编辑器里点选建表或写迁移文件.sql后运行npx insforge/cli db migrations up --all应用调接口带上令牌发起请求例如curl /api/database/records/posts -H Authorization: Bearer token三步走完以后每加一张表就自动多一份全套接口。✅ 这套方式帮你省了什么一张表就是一份接口改 schema 等于改 API不用维护一层 CRUD 代码权限规则收敛在数据库里RLS 策略加 JWTREST、SDK、实时订阅共用一套规则查询、分页、字段筛选内置每张表的 API 形态一致客户端好封装Web、移动端、桌面端共用一套接口SDK 类型安全细节可查官方文档数据库总览、REST 接口参考。【免费下载链接】InsForgeThe all-in-one, open-source backend platform for agentic coding. InsForge gives your coding agent database, auth, storage, compute, hosting, and AI gateway to ship full-stack apps end-to-end.项目地址: https://gitcode.com/GitHub_Trending/in/InsForge创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考