https://easyf.appTạo tải về với EasyF
EasyF hiển thị giao diện trước để các nhà phát triển có thể ước tính công việc của họ. Vẫn cần xem xét hỗ trợ trước khi có khóa trực tiếp và giới hạn sử dụng.
Bắt đầu nhanh
Để giải thích máy chủ API, EasyF tách thông tin đăng nhập kích hoạt hỗ trợ khỏi điểm cuối thuê được chỉ định. Quy trình làm việc ngôn ngữ đơn giản cung cấp một đường gọi chỉ dành cho máy chủ riêng biệt.
X-API-Key: pending_activation_…EasyfClientv1# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"
curl -X POST https://easyf.app/v1/resolve \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'An toàn thông tin đăng nhập bắt đầu với việc lưu trữ bí mật phía máy chủ trên EasyF. Chế độ xem tiếp theo không bao gồm nhúng gói khách hàng. Trang không giữ nhật ký công khai hoặc kho lưu trữ hiển thị.
Giải quyết một liên kết
Để giải thích hoạt động Resolve, EasyF tách việc phát hiện nguồn khỏi định dạng từ một URL được gửi. Quy trình làm việc ngôn ngữ đơn giản không dành chỗ cho các đầu ra được tạo ra một cách giả định.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
asset_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
}Định danh định dạng bắt đầu với giá trị trả về không thay đổi trên EasyF. Chế độ xem tiếp theo bao gồm khả năng truy cập theo liên kết. Trang không giữ nhãn chất lượng đoán được hiển thị.
Tạo và theo dõi công việc tải xuống
EasyF trình bày ba điểm thực tiễn cho Tạo công việc. Đầu tiên là chuẩn bị không đồng bộ. Quy trình làm việc ngôn ngữ đơn giản sau đó bao gồm một yêu cầu HTTP ngắn. Điểm 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ả |
|---|---|---|---|
asset_url | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
variant_code | 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://easyf.app/v1/jobs \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'delivery_id.GET /v1/jobs/{delivery_id} 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://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF tiếp cận việc kiểm tra công việc thông qua chờ đợi ban đầu một giây, sau đó giảm dần có giới hạn. Quy trình làm việc bằng ngôn ngữ đơn giản giữ cho việc giao hàng có ký tạm thời rõ ràng.
Những sai lầm có thể dự đoán
EasyF tổ chức Hợp đồng lỗi quanh một phong bì không phải 2xx. Quy trình làm việc ngôn ngữ đơn giản so sánh ID yêu cầu hỗ trợ. Xử lý khách hàng có thể dự đoán vẫn là kiểm tra cuối cù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
EasyF đồng ý các ranh giới sử dụng thực tế với mỗi sản phẩm được phê duyệt để bảo tồn một quy trình làm việc hướng dẫn có thể dự đoán được.
- 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.
Để giải thích truy cập Schema, EasyF tách biệt kích hoạt trước khi khám phá khỏi xác thực được chỉ định. Một quy trình làm việc bằng ngôn ngữ đơn giản cung cấp cho các hình dạng yêu cầu được ghi chép một vị trí riêng.
Kích hoạt thông qua hỗ trợ
Hãy cho EasyF biết bạn đang xây dựng gì, tần suất gọi API và nhà cung cấp nào quan trọng. Việc xem xét quyết định các thao tác được phép, sau đó tiết lộ một chứng chỉ một lần trong khi chỉ lưu trữ bản tóm tắt bảo mật của 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.