https://savetk.appTạo tải xuống với SaveTK
SaveTK hiển thị một kế hoạch API cho tích hợp công cụ người sáng tạo, nhưng không chấp nhận thực thi không xác thực. Phê duyệt cung cấp cả khóa và giới hạn hoạt động của nó.
Bắt đầu nhanh
SaveTK trình bày ba điểm thực tiễn cho máy chủ API. Đầu tiên là thông tin đăng nhập kích hoạt hỗ trợ. Quy trình lưu sau đó bao gồm một điểm cuối thuê bao được chỉ định. Điểm cuối cùng là đường dẫn gọi chỉ dành cho máy chủ.
X-API-Key: pending_activation_…SaveTkCreatorv1# 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 giúp việc quét an toàn Thông tin đăng nhập trở nên dễ dàng. Trang bắt đầu với lưu trữ bí mật phía máy chủ, chuyển sang không nhúng gói phía khách, và rõ ràng tuyên bố không có nhật ký công khai hay kho lưu trữ.
Giải quyết một liên kết
SaveTK trình bày ba điểm thực tiễn cho hoạt động Resolve. Đầu tiên là phát hiện nguồn. Quy trình lưu sau đó bao gồm các định dạng từ một URL được gửi. Điểm cuối cùng là không có đầu ra được tạo ra.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
creator_link | URL HTTPS | Có | Trang truyền thông công cộng hoặc được ủy quyền để phân tích. |
tenant | chuỗi | Không | Miền thuê bao được gán. Thường bỏ qua. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}SaveTK làm cho Định danh Định dạng dễ dàng quét. Trang bắt đầu với giá trị trả về không thay đổi, chuyển sang khả năng truy cập theo liên kết, và rõ ràng nêu không có nhãn chất lượng đoán mò.
Tạo và theo dõi công việc tải xuống
Tạo công việc bắt đầu với chuẩn bị không đồng bộ trên SaveTK. Quy trình lưu này sau đó trình bày một yêu cầu HTTP ngắn. Sự thật cuối cùng là thực thi công nhân có giới hạn.
/v1/jobsPhạm vi: công việc| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
creator_link | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
save_option | chuỗi | Có | Một ID chính xác từ đáp ứng giải quyết. |
tenant | chuỗi | Không | Miền thuê bao được gán. Thường bỏ qua. |
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"}'save_task.GET /v1/jobs/{save_task} với cùng một chìa khóa.| Tình trạng | Ý nghĩa | Hành động khách |
|---|---|---|
queued | Được nhận vào hàng đợi có giới hạn. | Bầu cử lại với backoff. |
extracting | Cập nhật siêu dữ liệu nguồn hoặc đường dẫn. | Tiếp tục bỏ phiếu. |
processing | Tải xuống, remuxing hoặc hợp nhất. | Hiển thị tiến độ máy chủ. |
ready | Tải xuống ký có sẵn. | Gửi URL cho người dùng. |
failed | Lỗi kết cấu đầu cuối. | Đọc error_code. Chỉ thử lại khi được khuyên. |
expired | Đầu ra tạm thời đã được loại bỏ. | Tạo một công việc mới. |
curl https://savetk.app/v1/jobs/SAVE_TASK \
-H "X-API-Key: $SAVETK_CREATOR_KEY"SaveTK xử lý việc kiểm tra công việc bằng cách xác định trước một khoảng chờ ban đầu một giây. Nó tiếp tục với việc giảm tần suất có giới hạn và giữ việc giao hàng tạm thời đã ký trong tầm nhìn.
Những sai lầm có thể dự đoán
Hợp đồng lỗi bắt đầu với một phong bì không phải 2xx trên SaveTK. Chế độ xem tiếp theo bao gồm một ID yêu cầu hỗ trợ. Trang giữ việc xử lý khách hàng có thể dự đoán được hiển thị.
{
"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 | Ý nghĩa điển hình | Hành động |
|---|---|---|
| 400 | URL không hợp lệ, thân hoặc định dạng không có sẵn. | Sửa yêu cầu. Giải quyết lại cho các định dạng. |
| 401 | Chìa khóa bị thiếu, không hợp lệ, hết hạn hoặc phạm vi sai. | Kiểm tra chứng chỉ bên máy chủ. |
| 403 | Chính sách thuê bao hoặc nguồn từ chối yêu cầu. | Không vượt qua chính sách Liên hệ hỗ trợ. |
| 404 | Công việc không rõ hoặc hết hạn. | Tạo một công việc mới nếu phù hợp. |
| 429 | Đã đạt giới hạn yêu cầu hoặc công việc hoạt động. | Danh dự retry_after_seconds. |
| 503 | Đường đợi/thể tích hoặc lên nguồn tạm thời không có sẵn. | Thử lại với backoff theo cấp số nhân và jitter. |
Hợp đồng vận hành
SaveTK thiết lập các khoản trợ cấp cho người tạo-luồng công việc sau khi xem xét lưu lượng dự kiến và các nền tảng đăng tải trong phạm vi.
- Sử dụng logic ứng dụng idempotent và không bao giờ bắt đầu các công việc trùng lặp cho cùng một lần nhấp của người dùng.
- Bộ nhớ đệm siêu dữ liệu giải quyết nhanh, nhưng luôn coi các URL tải xuống có chữ ký là hết hạn.
- Sử dụng backoff lũy thừa có giới hạn với jitter cho
429,503và lỗi có thể thử lại. - Xử lý chỉ truyền thông công cộng hoặc truyền thông bạn được phép truy cập. DRM và kiểm soát truy cập không được bỏ qua.
- Giữ ID yêu cầu và ID công việc trong các bản ghi hoạt động riêng. Không ghi URL gửi không cần thiết.
SaveTK trình bày ba điểm thực tiễn để truy cập Schema. Đầu tiên là kích hoạt trước khi khám phá. Quy trình lưu sau đó bao gồm xác thực được chỉ định. Điểm cuối cùng là các hình thức yêu cầu được ghi chép lại.
Kích hoạt thông qua hỗ trợ
Nêu rõ khách hàng SaveTK làm gì, số lần gọi mà nó mong đợi và dịch vụ đăng bài nào là cần thiết. Đánh giá hỗ trợ chọn phạm vi của nó, sau đó trả về một chứng chỉ không thể phục hồi được hiển thị một lần duy nhất.
Yêu cầu kích hoạt Chìa khóa được giới hạn phạm vi thuê bao, có thể hủy bỏ và được phát hành thông qua biểu mẫu Liên hệ. Skript ẩn danh không thể thực hiện công việc tải xuống.