REST API

从您自己的脚本保存和删除数百到数千页的文档。没有 AI 参与。

不用一份一份手动录入 PDF、表格、报告，整个过程交给脚本：由您自己提取并切分文本， 把结果发过来即可。

在这里保存的内容和通过连接的 AI 保存的完全一样——进同一个存储，您的 AI 也用同样的方式找回来。

没有读取 API。 搜索和取回仍由 MCP 和您的 仪表板负责。

开始使用

  1. 在 REST API 卡片里创建密钥——它在您的账户页面上。 密钥的名称会作为用它保存的一切内容的来源被记录下来，取一个日后认得出的名字，比如 Import script、pdf-importer。
  2. 密钥在创建之后只显示一次。请当场复制，之后无法再次显示。
  3. 密钥可以创建任意多个，也可以随时单独删除。

认证

Base URLhttps://contextick.ai
Authorization: Bearer api_xxxxxxxx

只有以 api_ 开头的密钥在这里有效。MCP 密钥或 OAuth 令牌在这个 API 上会得到 401，REST API 密钥在 MCP 端点上同样是 401——两个入口互相分开，撤销其中一个 不会影响另一个。

端点

POST /api/v1/notes

保存一条。

Body

FieldTypeRequiredLimit
titlestring✓120 个字符——超出会被截断
summarystring✓300 个字符——超出会被截断
contentstring✓16,000 个字符——超出会被拒绝

三个都不能为空；空值会被拒绝，而不是靠猜测填上。

Request

curl -X POST https://contextick.ai/api/v1/notes \
  -H "Authorization: Bearer api_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Q3 report","summary":"Revenue and headcount for Q3.","content":"…"}'

Response 201

{ "id": 42, "saved_items": 118, "stored_bytes": 1048576 }

saved_items 和 stored_bytes 是保存之后的总量。如果没能读到，字段会整个 省略，而不是给 0。

记录在条目上的来源就是密钥的名称，无法由请求指定。

DELETE /api/v1/notes/{id}

删除一条。

Request

curl -X DELETE https://contextick.ai/api/v1/notes/42 \
  -H "Authorization: Bearer api_xxxxxxxx"

POST /api/v1/notes/delete

一次删除多条。

Body

FieldTypeRequiredLimit
idsnumber[]✓每次 50 个——超出会被拒绝

批量导入之后要撤回，靠的就是这个。

Request

curl -X POST https://contextick.ai/api/v1/notes/delete \
  -H "Authorization: Bearer api_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"ids":[42,43]}'

Delete response 200

{ "deleted": [42], "not_found": [43], "saved_items": 117, "stored_bytes": 1040000 }

两个删除返回的形状相同。不存在的 id 不算错误，会列在 not_found 里。 删除是永久的，无法撤销。

长文档请自己切分

正文上限是每次保存 16,000 个字符。我们不会替您切分——超出的会以 content_too_long 拒绝。请把文档按意义完整的段落切开，逐段保存，并给每一段自己的标题和 摘要：文件名和小节标题您最清楚，这样之后也更容易找回来。

错误

所有失败都用同一种形状：

{ "error": { "code": "quota_exceeded", "message": "…" } }

请按 code 分支。message 是给人读的文字，可能随时改动。

400 改好请求再重试 empty_titleempty_summaryempty_contentcontent_too_longtoo_many_idsinvalid_bodyinvalid_id
401 检查 api_ 密钥 unauthorized
402 处理付款状态——期间取回仍然可用 payment_past_duesubscription_pausedsubscription_canceledrefund_pending
429 稍后重试同一请求 embedding_rate_limited
507 腾出空间或换更大的套餐——不要原样重试 quota_exceeded
503 500 临时问题或服务端问题——稍后重试

需要知道的