https://easyt.ioXây dựng tải xuống với EasyT
Tham chiếu EasyT này là hướng dẫn triển khai thay vì một điểm cuối ẩn danh hoạt động. Truy cập sản xuất chỉ bắt đầu sau khi bộ phận hỗ trợ phê duyệt khách hàng và phân bổ giới hạn.
Bắt đầu nhanh
Máy chủ API bắt đầu với thông tin xác thực được kích hoạt hỗ trợ trên EasyT. Kiểm tra hướng dẫn này sau đó trình bày một điểm cuối thuê bao được chỉ định. Sự thật cuối cùng là một đường dẫn gọi chỉ dành cho máy chủ.
X-API-Key: pending_activation_…EasytWorkspacev1# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"
curl -X POST https://easyt.io/v1/resolve \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Trong EasyT, lưu trữ bí mật phía máy chủ được ưu tiên khi giải thích về an toàn Thông tin đăng nhập. Kiểm tra hướng dẫn tiếp theo không có nhúng gói khách hàng và kết thúc với không có nhật ký công khai hay kho lưu trữ.
Giải quyết một liên kết
Hoạt động giải quyết bắt đầu với việc phát hiện nguồn trên EasyT. Kiểm tra có hướng dẫn này sau đó trình bày các định dạng từ một URL đã gửi. Sự thật cuối cùng là 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ả |
|---|---|---|---|
input_url | 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
}Trong EasyT, giá trị trả về không thay đổi được đưa lên đầu khi giải thích Định danh định dạng. Việc kiểm tra có hướng dẫn này tiếp theo với khả năng truy cập theo liên kết và kết thúc mà không có nhãn chất lượng đoán được.
Tạo và theo dõi công việc tải xuống
Chuẩn bị không đồng bộ là điểm khởi đầu cho Tạo công việc trên EasyT. Một kiểm tra hướng dẫn sau đó trình bày một yêu cầu HTTP ngắn và giải thích việc 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ả |
|---|---|---|---|
input_url | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
stream_choice | 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://easyt.io/v1/jobs \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'workspace_job.GET /v1/jobs/{workspace_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://easyt.io/v1/jobs/WORKSPACE_JOB \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN"Đối với việc thăm dò công việc, EasyT bắt đầu với thời gian chờ ban đầu một giây. Kiểm tra có hướng dẫn của nó kết hợp điều đó với việc giới hạn thời gian chờ và kết thúc bằng giao hàng tạm thời có ký.
Những sai lầm có thể dự đoán
EasyT giúp hợp đồng Lỗi dễ dàng quét. Trang bắt đầu với một phong bì không phải 2xx, chuyển sang ID yêu cầu hỗ trợ, và nêu rõ 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
EasyT chọn một hạn mức hoạt động trong quá trình xem xét, cân bằng nhu cầu của ứng dụng với sức khỏe của nhà cung cấp.
- 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.
Truy cập lược đồ bắt đầu với kích hoạt trước khi khám phá trên EasyT. Kiểm tra có hướng dẫn này sau đó trình bày xác thực được chỉ định. Sự thật cuối cùng là các hình thức yêu cầu được ghi lại.
Kích hoạt thông qua hỗ trợ
Bao gồm mục đích khách hàng, khối lượng công việc hàng tháng dự kiến và các mạng yêu cầu trong ghi chú kích hoạt. EasyT sau đó có thể chọn phạm vi giải quyết và công việc đúng trước khi tạo ra một bí mật một cái nhì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.