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