https://quickdl.appXây dựng tải xuống với QuickDL
QuickDL cho phép nhà phát triển kiểm tra mô hình yêu cầu nhỏ gọn trước khi kích hoạt. Hỗ trợ phải xác thực sản phẩm trước khi khóa riêng và hạn ngạch trở nên có thể sử dụng.
Bắt đầu nhanh
Trong QuickDL, thông tin đăng nhập kích hoạt hỗ trợ được đề cập đầu tiên khi giải thích về máy chủ API. Tiện ích gọn nhẹ đó tiếp theo với điểm cuối thuê bao được chỉ định và kết thúc bằng đường dẫn gọi chỉ dành cho máy chủ.
X-API-Key: pending_activation_…QuickDlJobsv1# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"
curl -X POST https://quickdl.app/v1/resolve \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickDL xử lý an toàn Thông tin đăng nhập bằng cách đầu tiên xác định lưu trữ bí mật phía máy chủ. Nó không nhúng gói khách hàng nào và không giữ nhật ký công khai hay kho lưu trữ nào trong tầm nhìn.
Giải quyết một liên kết
Trong QuickDL, phát hiện nguồn được thực hiện đầu tiên khi giải thích hoạt động Resolve. Tiện ích gọn nhẹ đó tiếp theo với các định dạng từ một URL đã gửi và kết thúc mà không tạo ra đầu ra giả mạo.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
public_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
}QuickDL xử lý Định danh định dạng bằng cách đầu tiên xác định giá trị trả về không thay đổi. Nó tiếp tục với khả năng truy cập theo liên kết và không giữ nhãn chất lượng đoán trước trong tầm nhìn.
Tạo và theo dõi công việc tải xuống
Tiện ích nhỏ gọn của QuickDL đánh giá việc chuẩn bị không đồng bộ cho việc tạo Công việc. Nó hiển thị một yêu cầu HTTP ngắn tiếp theo và không che khuất việc thực thi công nhân bị ràng buộc.
/v1/jobsPhạm vi: công việc| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
public_link | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
download_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://quickdl.app/v1/jobs \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'quick_job.GET /v1/jobs/{quick_job} 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://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL trình bày ba điểm thực tiễn cho việc thăm dò công việc. Đầu tiên là chờ đợi ban đầu một giây. Tiện ích nhỏ gọn sau đó bao gồm việc giảm tải có giới hạn. Điểm cuối cùng là giao hàng tạm thời có ký.
Những sai lầm có thể dự đoán
QuickDL tiếp cận hợp đồng Lỗi thông qua một phong bì không phải 2xx, sau đó là một ID yêu cầu hỗ trợ. Tiện ích gọn nhẹ giữ xử lý khách hàng có thể dự đoán rõ ràng.
{
"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
QuickDL cấp một hạn ngạch đặc biệt cho khách hàng nhỏ gọn hỗ trợ tích hợp mà không làm mất ổn định các dịch vụ nguồn.
- 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.
Trong QuickDL, kích hoạt trước khi khám phá được đề cập đầu tiên khi giải thích truy cập Lược đồ. Tiện ích gọn nhẹ đó tiếp theo với xác thực được chỉ định và kết thúc bằng các hình thức yêu cầu đã được tài liệu hóa.
Kích hoạt thông qua hỗ trợ
Cung cấp cho QuickDL tên tích hợp, khối lượng dự kiến hàng tháng và các nguồn cần thiết. Xác định các hoạt động mà máy chủ sẽ thực hiện để phê duyệt tạo ra một khóa một lần có phạm vi hẹp.
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.