https://insts.ioXây dựng tải xuống với Insts
Bàn làm việc Insts dưới đây là tài liệu dành cho khách hàng tiềm năng. Việc xem xét của người vận hành diễn ra trước khi bất kỳ chứng chỉ thực thi hoặc quyền gọi nào được tạo ra.
Bắt đầu nhanh
Máy chủ API bắt đầu với thông tin đăng nhập được kích hoạt hỗ trợ trên Insts. Chế độ xem tiếp theo bao gồm một điểm cuối thuê bao được chỉ định. Trang giữ cho đường dẫn gọi chỉ máy chủ luôn hiển thị.
X-API-Key: pending_activation_…InstsConnectv1# Available only after support activation
export INSTS_CONNECT_SECRET="issued-after-review"
curl -X POST https://insts.io/v1/resolve \
-H "X-API-Key: $INSTS_CONNECT_SECRET" \
-H "Content-Type: application/json" \
-d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID"}'Lưu trữ bí mật phía máy chủ là điểm khởi đầu cho an toàn thông tin đăng nhập trên Insts. Một bàn kiểm tra sau đó không trình bày gói khách hàng nhúng và giải thích không có nhật ký công khai hoặc 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 Insts. Chế độ xem tiếp theo bao gồm các định dạng từ một URL đã gửi. Trang không giữ bất kỳ đầu ra giả định nào hiển thị.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
shared_post | 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á trị trả về không thay đổi là điểm khởi đầu cho định danh Định dạng trên Insts. Một bàn kiểm tra sau đó trình bày khả năng sẵn có theo liên kết và giải thích không có nhãn chất lượng đoán mò.
Tạo và theo dõi công việc tải xuống
Insts giúp tạo Công việc dễ dàng quét. Trang bắt đầu với chuẩn bị không đồng bộ, chuyển sang yêu cầu HTTP ngắn, và rõ ràng tuyên bố 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ả |
|---|---|---|---|
shared_post | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
asset_option | 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://insts.io/v1/jobs \
-H "X-API-Key: $INSTS_CONNECT_SECRET" \
-H "Content-Type: application/json" \
-d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID","asset_option":"18"}'connect_job.GET /v1/jobs/{connect_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://insts.io/v1/jobs/CONNECT_JOB \
-H "X-API-Key: $INSTS_CONNECT_SECRET"Đối với việc kiểm tra công việc, Insts kiểm tra thời gian chờ ban đầu một giây trước khi áp dụng giới hạn tăng dần. Bàn kiểm tra này cũng làm rõ việc giao hàng có chữ ký tạm thời.
Những sai lầm có thể dự đoán
Hợp đồng lỗi bắt đầu với một phong bì không phải 2xx trên Insts. Bàn kiểm tra này sau đó trình bày một ID yêu cầu hỗ trợ. Sự thật cuối cùng là 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
Insts thiết lập giới hạn tỷ lệ tại thời điểm xem xét để bảo vệ không gian làm việc kiểm tra và mọi tuyến 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 Insts. Chế độ xem tiếp theo bao gồm xác thực được chỉ định. Trang giữ các hình dạng yêu cầu đã được ghi chép hiển thị.
Kích hoạt thông qua hỗ trợ
Chia sẻ trường hợp sử dụng bàn làm việc, ước tính số cuộc gọi và các dịch vụ đang được kiểm tra. Insts xem xét ranh giới đó trước khi thông tin đăng nhập của người thuê được hiển thị một lần và giảm xuống thành một hàm băm đã lưu.
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.