https://quickt.ioTạo bản tải xuống với QuickT
QuickT ghi lại cách một khách hàng di động sẽ giao tiếp với dịch vụ. Nó không thể gửi công việc sản xuất cho đến khi bộ phận hỗ trợ phê duyệt thiết kế và kích hoạt quyền truy cập có phạm vi.
Bắt đầu nhanh
Đối với máy chủ API, QuickT kiểm tra thông tin xác thực được kích hoạt hỗ trợ trước một điểm cuối thuê được chỉ định. Chế độ xem sẵn sàng thiết bị này cũng làm rõ đường dẫn gọi chỉ dành cho máy chủ.
X-API-Key: pending_activation_…QuicktRoutev1# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"
curl -X POST https://quickt.io/v1/resolve \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickT tổ chức an toàn thông tin đăng nhập xung quanh việc lưu trữ bí mật phía máy chủ. Chế độ xem sẵn sàng cho thiết bị không so sánh việc nhúng gói khách hàng. Không có nhật ký công khai hoặc kho lưu trữ nào còn lại là kiểm tra cuối cùng.
Giải quyết một liên kết
Đối với thao tác Resolve, QuickT kiểm tra phát hiện nguồn trước khi định dạng từ một URL đã gửi. Chế độ xem sẵn sàng cho thiết bị này cũng làm rõ không có đầu ra giả tạo.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
route_source | 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
}QuickT tổ chức định danh Định dạng xung quanh giá trị trả về không thay đổi. Chế độ xem sẵn sàng thiết bị của nó so sánh tính khả dụng theo liên kết. Không còn nhãn chất lượng đoán được làm kiểm tra cuối cùng.
Tạo và theo dõi công việc tải xuống
Để giải thích Tạo việc làm, QuickT tách biệt việc chuẩn bị không đồng bộ khỏi một yêu cầu HTTP ngắn. Một giao diện sẵn sàng cho thiết bị cung cấp cho việc thực thi công nhân có giới hạn một vị trí riêng.
/v1/jobsPhạm vi: công việc| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
route_source | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
route_format | 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://quickt.io/v1/jobs \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'route_job.GET /v1/jobs/{route_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://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Chờ đợi ban đầu một giây là điểm khởi đầu cho việc truy vấn công việc trên QuickT. Một giao diện sẵn sàng thiết bị sau đó trình bày việc giảm tần suất truy vấn có giới hạn và giải thích việc giao hàng tạm thời đã ký.
Những sai lầm có thể dự đoán
Đối với hợp đồng Lỗi, QuickT bắt đầu với một phong bì không phải 2xx. Giao diện sẵn sàng thiết bị của nó kết hợp điều đó với một ID yêu cầu hỗ trợ và kết thúc bằng xử lý khách hàng có thể dự đoán.
{
"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
QuickT chọn giới hạn di động-khách hàng trong quá trình phê duyệt để các mạng lưới người tạo và API vẫn đáp ứng.
- 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.
Đối với truy cập Schema, QuickT kiểm tra kích hoạt trước khi khám phá và trước khi xác thực được phân công. Giao diện sẵn sàng thiết bị này cũng làm 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ợ
Mô tả trải nghiệm di động, kỳ vọng lưu lượng và các mạng người sáng tạo mà nó cần. QuickT sử dụng thông tin đó để phân công phân tích và quyền hàng đợi trước khi tiết lộ bí mật 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.