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 暫時性問題或伺服器端問題——稍後重試

需要知道的