https://ffast.appXây dựng các lượt tải với FFast
FFast phơi bày hình dạng API dự kiến mà không bật các cuộc gọi công khai. Người vận hành kích hoạt thông tin đăng nhập và hạn ngạch đo lường sau khi xem xét tích hợp đề xuất.
Bắt đầu nhanh
FFast tiếp cận máy chủ API thông qua thông tin đăng nhập được kích hoạt hỗ trợ, sau đó là điểm cuối thuê bao được chỉ định. Đánh giá nhanh giữ cho đường gọi chỉ dành cho máy chủ rõ ràng.
X-API-Key: pending_activation_…FfastPipelinev1# Available only after support activation
export FFAST_PIPELINE_KEY="issued-after-review"
curl -X POST https://ffast.app/v1/resolve \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'Để đảm bảo an toàn thông tin đăng nhập, FFast kiểm tra lưu trữ bí mật phía máy chủ trước khi không nhúng gói khách hàng. Việc rà soát nhanh này cũng không tạo ra nhật ký công khai hay kho lưu trữ rõ ràng.
Giải quyết một liên kết
FFast tiếp cận thao tác Resolve thông qua phát hiện nguồn, sau đó định dạng từ một URL đã gửi. Đánh giá nhanh không giữ lại các kết quả tạo ra rõ ràng.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
fast_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
}Đối với định danh Định dạng, FFast kiểm tra giá trị trả về không thay đổi trước khi khả dụng theo liên kết. Đánh giá nhanh này cũng không làm rõ nhãn chất lượng đoán trước.
Tạo và theo dõi công việc tải xuống
FFast xử lý việc tạo Công việc bằng cách đầu tiên xác định chuẩn bị không đồng bộ. Nó tiếp tục với một yêu cầu HTTP ngắn và giữ việc thực thi công nhân có giới hạn trong tầm nhìn.
/v1/jobsPhạm vi: công việc| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
fast_source | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
output_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://ffast.app/v1/jobs \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'pipeline_run.GET /v1/jobs/{pipeline_run} 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://ffast.app/v1/jobs/PIPELINE_RUN \
-H "X-API-Key: $FFAST_PIPELINE_KEY"Việc kiểm tra công việc bắt đầu với thời gian chờ ban đầu một giây trên FFast. Lượt xem tiếp theo bao gồm việc giảm tần suất có giới hạn. Trang giữ cho việc giao hàng có chữ ký tạm thời luôn hiển thị.
Những sai lầm có thể dự đoán
Đánh giá nhanh của FFast xem xét một phong bì không phải 2xx cho hợp đồng Lỗi. Nó hiển thị một ID yêu cầu hỗ trợ tiếp theo và không che khuất việc 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
FFast kích hoạt các hạn mức đo lường giữ cho việc chuyển giao phản hồi nhanh mà không gây tải không an toàn lên các nền tảng thượng 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.
FFast tiếp cận truy cập Lược đồ thông qua kích hoạt trước khi khám phá, sau đó xác thực được chỉ định. Đánh giá nhanh giữ các hình dạng yêu cầu được tài liệu rõ ràng.
Kích hoạt thông qua hỗ trợ
Cung cấp cho FFast một bản tóm tắt sản phẩm ngắn gọn, dự báo lưu lượng và danh sách nền tảng. Nêu rõ có cần kiểm tra siêu dữ liệu, công việc đã chuẩn bị hay cả hai để khóa phát hành phù hợp với quy trình làm việc thực tế.
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.