https://ytsave.appTải xuống bản dựng với YTSave
Giải quyết URL phương tiện công khai, chọn định dạng chính xác, tạo công việc không đồng bộ và chuyển kết quả đã ký cho người dùng của bạn. Cùng một quy trình sản xuất ràng buộc cung cấp năng lượng cho trang web YTSave.
Bắt đầu nhanh
YTSave xử lý máy chủ API bằng cách đầu tiên xác định các thông tin đăng nhập được kích hoạt hỗ trợ. Nó tiếp tục với một điểm cuối thuê bao được chỉ định và giữ một đường dẫn gọi chỉ dành cho máy chủ trong tầm nhìn.
X-API-Key: ys_live_…YTSaveClientv1# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"
curl -X POST https://ytsave.app/v1/resolve \
-H "X-API-Key: $YTSAVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Để giải thích An toàn chứng chỉ, YTSave tách lưu trữ bí mật phía máy chủ khỏi việc nhúng gói khách hàng. Một hồ sơ bằng chứng không dành vị trí riêng cho nhật ký công khai hoặc kho lưu trữ.
Giải quyết một liên kết
YTSave xử lý thao tác Giải quyết bằng cách đầu tiên xác định phát hiện nguồn. Nó theo sau với các định dạng từ một URL đã gửi và không giữ các đầu ra được tạo ra trong chế độ xem.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
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
}Để giải thích Định danh định dạng, YTSave tách giá trị trả về không thay đổi khỏi khả năng truy cập theo liên kết. Một hồ sơ bằng chứng không dành vị trí riêng cho nhãn chất lượng đoán được.
Tạo và theo dõi công việc tải xuống
Đối với Tạo công việc, YTSave bắt đầu với chuẩn bị không đồng bộ. Bản ghi bằng chứng của nó kết hợp điều đó với một yêu cầu HTTP ngắn và kết thúc với 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ả |
|---|---|---|---|
url | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
format_id | 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://ytsave.app/v1/jobs \
-H "X-API-Key: $YTSAVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'job_id.GET /v1/jobs/{job_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://ytsave.app/v1/jobs/JOB_ID \
-H "X-API-Key: $YTSAVE_API_KEY"YTSave làm cho việc kiểm tra công việc dễ dàng quét. Trang bắt đầu với thời gian chờ ban đầu một giây, chuyển sang giảm dần có giới hạn, và rõ ràng nêu giao hàng tạm thời có chữ ký.
Những sai lầm có thể dự đoán
Đối với hợp đồng lỗi, YTSave kiểm tra một phong bì không phải 2xx trước một ID yêu cầu hỗ trợ. Bản ghi bằng chứng này cũng làm rõ việc 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
YTSave phát hành một hạn ngạch hoạt động với mỗi sự chấp thuận để bảo vệ người tiêu dùng API và các dịch vụ truyền thông phía trê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.
YTSave xử lý truy cập Schema bằng cách xác định kích hoạt trước khi khám phá. Nó tiếp tục với xác thực được chỉ định và giữ các hình dạng yêu cầu đã được ghi chép trong chế độ xem. Tham khảo OpenAPI
Yêu cầu khóa API của bạn
Ghi lại người tiêu dùng API, ước tính yêu cầu hàng tháng và các yêu cầu nền tảng được hỗ trợ. YTSave xem xét liệu việc giải quyết, gửi công việc hay cả hai có được biện minh trước khi phát hành khóa chỉ hiển thị một lần.
Yêu cầu truy cập API 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.