SQLite REST API：将 SQL 查询转换为端点

REST API · SQLite 到端点

转动 SQLite SQL 查询结果 REST API 端点

在查询构建器中保存查询，然后单击 新端点, and you have a URL at api.querystreams.com with its own key. The SQL runs read-only on the Agent that already reads your SQLite file; the caller gets JSON or CSV and never sees the SQL, the schema or a password. Nothing to host, no port to open. About 90 seconds from a saved query, and the Free plan covers your first endpoint.

从已保存的查询算起大约需要 90 秒 没有服务器可供托管 文件位置不变 每个来电者一个密钥，可随时撤销

你最终会得到什么

网址 api.querystreams.com 它会将您保存的 SQLite 查询结果以 JSON 或 CSV 格式返回给任何拥有密钥的人，在您共享之前，请先在门户网站的控制台中进行测试。例如：

{
  “城市”: “西雅图”
}

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"city": "Seattle"}'

{
  “列”: [ { “姓名”: "customer_id", “类型”: 整数 }, { “姓名”: “姓名”, “类型”: “细绳” }, { “姓名”: “城市”, “类型”: “细绳” } ],
  “行”: [
    { "customer_id": 1042, “姓名”: “北风贸易公司”, “城市”: “西雅图” },
    { "customer_id": 1057, “姓名”: “高山装备店”, “城市”: “丹佛” },
    { "customer_id": 1063, “姓名”: “港口食品”, “城市”: “哈利法克斯” }
  ],
  “元”: { 行数: 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

SQLite holds your data in a file on a computer you control. Someone else wants a slice of it in their app, their dashboard or their script, and the usual answers all hand over too much: a database login that outlives the project, a nightly export that is stale by breakfast, or a small API server that somebody now has to run and patch. Query Streams makes the endpoint a saved query plus a key. The Agent that already reads your SQLite file runs the query, api.querystreams.com checks the key and the rate limit, and the caller gets rows. The SQL, the schema and the credentials never leave your account.

你需要准备什么

查询流帐户

每个套餐都提供 REST API。免费套餐提供一个端点、两个键，每次调用最多可发送 250 行数据，足以构建本指南。立即注册！ my.querystreams.com.

The Agent with your SQLite file added as a connection

还没完成吗？ 首先连接 SQLite大约需要十分钟。

查询生成器中已保存的查询

该端点仅封装一个已保存的查询。编写 SELECT 语句，运行一次，然后保存。添加动态筛选器（ @variable 在 WHERE 子句中）如果调用者应该能够进行筛选。

分四步完成设置

1. 保存查询

   在 查询生成器 选择你的 SQLite 连接，编写你想发布的 SELECT 语句，然后运行一次以查看结果行。确保只包含调用者需要的列；端点会返回查询语句的确切结果。

   已保存查询 · 客户

   选择 客户ID、姓名、城市
   从 客户
   命令 经过 名字
   限制 100;

   如果呼叫者需要能够进行筛选，请添加动态筛选器，例如 条件：城市 = @city。 每个 @variable 在步骤 3 中，它会成为一个 API 参数。点击 节省 并为查询命名；该名称将成为端点的显示名称。

2. 创建端点

   打开 API 点击顶部栏并单击 新端点该向导有四个步骤： 选择查询, 配置, 锁定参数 和 共享。 在 选择查询单击您刚刚保存的查询；代理离线的查询会显示为灰色。单击 下一页.

   开放 API

   捷径。 您可以从查询构建器直接显示已打开的查询；然后向导将从此处开始。 配置 查询语句已选定。

3. 配置并锁定参数

   在 配置 对于第一个端点来说，默认值是正确的： 显示名称 根据查询结果填写， 寿命 永久（选择） 即将到期 （临时份额） 响应模式 静态（一个 JSON 响应；选择） 流媒体 对于超出计划静态行上限的结果）， 内页格式 JSON。响应模式和格式一旦创建就固定不变，因此请在此处决定。点击 下一页.

   在 锁定参数 查询中的每个动态筛选器都会列出。保留调用者可能设置的筛选器。 可调用 并给每个人一个 查询字符串名称; 打钩 必需的 如果调用没有指定该值，则调用应失败。固定一个调用者不得更改的值。 已锁定或者类似这样的约会场景 月初. 隐 保留查询自身的默认值，并拒绝任何设置默认值的尝试。点击 下一页.

4. 分享即可获得您的钥匙

   在 共享 你可以邀请 人们 通过电子邮件或添加 服务密钥 可以是服务器或自动化工具，或者暂时两者都跳过。点击 创建并获取我的密钥成功屏幕会显示端点 URL 和您的密钥：一个以“.”开头的 49 个字符的字符串。 qsapi_复制它。稍后您可以从端点再次显示它。 共享 标签页，这样即使关闭屏幕也不会丢失。

   点击 发送 在控制台中，从门户本身发出第一个调用。响应窗格显示 现状, 时间 和 尺寸， 这 身体 标签页显示 JSON 数据，调用信息显示在标签页上。 活动 几秒钟后按下 Tab 键。

无论从哪里拨打电话

将端点 ID 替换为控制台地址栏中的您自己的端点 ID， qsapi_YOUR_KEY 使用您的密钥。可调用参数放在 GET 请求的查询字符串中；这里保存的查询会公开 城市:

curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "X-API-Key: qsapi_YOUR_KEY"

{
  “列”: [ { “姓名”: "customer_id", “类型”: 整数 }, { “姓名”: “姓名”, “类型”: “细绳” }, { “姓名”: “城市”, “类型”: “细绳” } ],
  “行”: [
    { "customer_id": 1042, “姓名”: “北风贸易公司”, “城市”: “西雅图” },
    { "customer_id": 1057, “姓名”: “高山装备店”, “城市”: “丹佛” },
    { "customer_id": 1063, “姓名”: “港口食品”, “城市”: “哈利法克斯” }
  ],
  “元”: { 行数: 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

返回的行是以列名为键的对象，包含列列表和一个 元 该信息块会告诉你有多少行数据、结果是否被截断以及你可以引用的请求 ID。与 POST 请求相同的操作会将参数放在 JSON 正文中，这对于较长的值列表来说是合适的选择：

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"params": {"city": "Seattle"}}'

格式=csv

格式为 CSV 而非 JSON，包含表头行。 接受：文本/CSV 也一样。流式端点返回 NDJSON（每行一个 JSON 对象），并以结尾结尾。 {"_summary": true, "row_count": N} 检查最后一行。

?sample=true

最多五排，不计费。适合给客户接线。

压缩=lz4

适用于高流量呼叫者的 LZ4 框架机身，配备解码器； 代码 选项卡中包含每种语言的解码器代码片段。客户端发送文件时，会自动进行纯 gzip 压缩。 Accept-Encoding: gzip.

授权：Bearer qsapi_…

被接受为别名 X-API密钥. 在浏览器代码中使用它。

它的插头在哪里

这些计划允许什么？

每次调用都有固定的 60 秒查询超时时间和 8 MiB 的响应大小上限，返回的数据量会计入您套餐的每月数据流量限额，与 Excel 和 Google Sheets 插件使用的限额相同。免费套餐只有一个端点，每月 5 MB 流量，足以满足每天多次调用的小型表格的需求。 请查看定价页面 按计划发放津贴。

确保安全

当某些事情不起作用时

每个错误体都有其形状 {"error": {"code": "…", "message": "…"}} 每个回应都包含一个 X-QS-请求-ID 邮件头。在联系客服时，请将 ID 号括起来。

人们提出的问题

相关指南

• 如何将 SQLite 连接到 Google Sheets
• 使用 MCP 将 SQLite 连接到 Claude
• 数据库 REST API：将任何 SQL 查询转换为端点
• Microsoft SQL Server REST API
• PostgreSQL REST API
• MySQL REST API