https://socialvideosaver.comXây dựng tải xuống với Social Video Saver
SocialVideoSaver cung cấp sơ đồ đa mạng này cho kế hoạch kỹ thuật. Thông tin xác thực sản xuất vẫn bị tắt cho đến khi trường hợp sử dụng được đề xuất vượt qua đánh giá hỗ trợ.
Bắt đầu nhanh
Thông tin đăng nhập kích hoạt hỗ trợ là điểm khởi đầu cho máy chủ API trên SocialVideoSaver. Một chế độ xem đa nguồn sau đó trình bày điểm cuối thuê bao được chỉ định và giải thích đường dẫn gọi chỉ dành cho máy chủ.
X-API-Key: pending_activation_…SocialSaverWorkspacev1# Available only after support activation
export SVS_WORKSPACE_KEY="issued-after-review"
curl -X POST https://socialvideosaver.com/v1/resolve \
-H "X-API-Key: $SVS_WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Chế độ xem đa nguồn của SocialVideoSaver xem xét việc lưu trữ bí mật phía máy chủ để đảm bảo an toàn thông tin đăng nhập. Nó không hiển thị việc nhúng gói khách hàng tiếp theo và không che giấu các nhật ký hoặc kho lưu trữ công khai nào.
Giải quyết một liên kết
Phát hiện nguồn là điểm khởi đầu cho thao tác Giải quyết trên SocialVideoSaver. Một chế độ xem đa nguồn sau đó trình bày các định dạng từ một URL đã gửi và giải thích không có đầu ra được tạo ra.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
social_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
}Chế độ xem đa nguồn của SocialVideoSaver xem xét giá trị trả về không thay đổi cho định danh Định dạng. Nó hiển thị khả năng truy cập theo liên kết tiếp theo và không che khuất nhãn chất lượng không đoán được.
Tạo và theo dõi công việc tải xuống
SocialVideoSaver tiếp cận Tạo việc làm thông qua chuẩn bị không đồng bộ, sau đó là một yêu cầu HTTP ngắn. Chế độ xem đa nguồn giữ cho việc thực thi công nhân có giới hạn trở nên rõ ràng.
/v1/jobsPhạm vi: công việc| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
social_url | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
media_profile | 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://socialvideosaver.com/v1/jobs \
-H "X-API-Key: $SVS_WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'delivery_job.GET /v1/jobs/{delivery_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://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
-H "X-API-Key: $SVS_WORKSPACE_KEY"SocialVideoSaver tổ chức việc kiểm tra công việc với thời gian chờ ban đầu khoảng một giây. Chế độ xem đa nguồn của nó so sánh việc giảm tốc độ có giới hạn. Giao hàng ký tạm thời vẫn là kiểm tra cuối cùng.
Những sai lầm có thể dự đoán
Trong SocialVideoSaver, một phong bì không phải 2xx xuất hiện đầu tiên khi giải thích Hợp đồng Lỗi. Chế độ xem đa nguồn đó tiếp theo với 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
SocialVideoSaver xem xét nhu cầu xuyên mạng dự kiến trước khi gán giới hạn cho sự tích hợp được phê duyệt.
- 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.
Kích hoạt trước khi khám phá là điểm khởi đầu để truy cập Schema trên SocialVideoSaver. Một chế độ xem đa nguồn sau đó trình bày xác thực được chỉ định và giải thích các dạng yêu cầu đã được tài liệu hóa.
Kích hoạt thông qua hỗ trợ
Tóm tắt sản phẩm đa mạng, dự báo nhu cầu hàng tháng và mọi nhà cung cấp mạng xã hội trong phạm vi.
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.