僅限預覽 — 需要啟用

使用 SaveTK 建立下載

SaveTK 顯示創作者工具整合的 API 計劃，但不接受未經身份驗證的執行。批准同時提供金鑰及其操作限制。

SaveTkCreatorHTTPS 上的 JSON非同步工作範圍限定的憑證

快速開始

SaveTK 提供三個實用的 API 主機要點。首先是支援啟用的憑證。接著的儲存工作流程涵蓋指定的租戶端點。最後一點是僅限伺服器的呼叫路徑。

租戶網址https://savetk.app

身份驗證X-API-Key: pending_activation_…

用戶端設定檔SaveTkCreator

API 版本v1

# Available only after support activation
export SAVETK_CREATOR_KEY="issued-after-review"

curl -X POST https://savetk.app/v1/resolve \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

SaveTK 使憑證安全易於掃描。該頁面從伺服器端秘密存儲開始，轉向不嵌入客戶端套件，並明確說明無公共日誌或存儲庫。

解析連結

SaveTK 提出了解決操作的三個實用要點。首先是來源檢測。保存工作流程接著涵蓋來自一個提交 URL 的格式。最後一點是不產生虛構輸出。

發佈/v1/resolve範圍：解析

欄位	類型	必填	描述
`creator_link`	HTTPS 網址	是	公開或授權的媒體頁面進行分析。
`tenant`	字串	否	指定的租戶網域。通常省略。

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

SaveTK 使格式識別器易於掃描。頁面以返回值不變開始，接著是每個連結的可用性，並明確說明沒有猜測的品質標籤。

建立並追蹤下載工作

工作創建從 SaveTK 的非同步準備開始。此保存工作流程隨後呈現簡短的 HTTP 請求。最終事實是受限的工作者執行。

發佈/v1/jobs範圍：工作

欄位	類型	必填	描述
`creator_link`	HTTPS 網址	是	提交相同的標準化來源以進行解析。
`save_option`	字串	是	解析回應中的精確 ID。
`tenant`	字串	否	指定的租戶網域。通常省略。

curl -X POST https://savetk.app/v1/jobs \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'

1202 已接受儲存 save_task.

2投票狀態GET /v1/jobs/{save_task} 使用相同的金鑰。

3準備好開啟已簽署的下載網址。

狀態	意義	客戶操作
`queued`	已加入有界佇列。	再次投票並退避。
`extracting`	正在刷新來源元資料或路由。	繼續輪詢。
`processing`	下載、重封裝或合併。	顯示伺服器進度。
`ready`	已提供簽署下載。	將 URL 傳送給使用者。
`failed`	終端結構化錯誤。	閱讀 `error_code`. 僅在建議時重試。
`expired`	暫時輸出已被移除。	建立新工作。

curl https://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

SaveTK 透過先識別一秒的初始等待來處理工作輪詢。接著採用限制的退避機制，並持續關注臨時簽署的交付。

可預測的錯誤

錯誤合約從 SaveTK 的一個非 2xx 信封開始。下一個視圖涵蓋支援請求 ID。頁面保持可預測的客戶端處理可見。

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	典型含義	動作
400	無效的 URL、內容或格式不可用。	修正請求。重新解析格式。
401	缺少、無效、過期或範圍錯誤的金鑰。	檢查伺服器端憑證。
403	租戶或來源政策拒絕了請求。	請勿繞過政策。請聯絡支援。
404	未知或已過期的工作。	如適用，請建立一個新工作。
429	已達請求或進行中工作限制。	榮譽 `retry_after_seconds`.
503	佇列/容量或上游暫時無法使用。	使用指數退避和抖動重試。

操作合約

SaveTK 在檢查預期流量和範圍內的發布平台後，設定創作者工作流程的許可權。

使用冪等的應用程式邏輯，切勿為同一使用者點擊啟動重複的工作。
暫時快取解析的元資料，但始終將簽署的下載 URL 視為會過期。
對…使用帶抖動的有界指數退避 429, 503 以及可重試的錯誤。
僅處理公開媒體或您有權訪問的媒體。不會繞過 DRM 和存取控制。
在私人操作日誌中保留請求 ID 和工作 ID。請勿不必要地記錄提交的 URL。

SaveTK 提出三個實用的 Schema 存取要點。首先是啟動，然後是探索。儲存工作流程接著涵蓋指定的身份驗證。最後一點是有文件記錄的請求形式。

經營者審核存取

透過客服啟用

說明 SaveTK 用戶端的功能、預期的呼叫次數以及哪些發佈服務是必要的。支援審查選擇其範圍，然後返回一次性顯示的不可恢復憑證。

請求啟用金鑰是租戶範圍內的，可撤銷，並通過聯絡表單發行。匿名腳本無法執行下載器工作。