https://insto.appTạo tải về với Insto
Insto trình bày một bản thiết kế tích hợp phương tiện hình ảnh để đánh giá. Phân tích trực tiếp và yêu cầu công việc vẫn không khả dụng cho đến khi hỗ trợ cấp quyền ủy quyền theo phạm vi người thuê.
Bắt đầu nhanh
Đối với máy chủ API, Insto bắt đầu với thông tin xác thực được kích hoạt bởi hỗ trợ. Đánh giá tải xuống của nó kết hợp điều đó với một điểm cuối người thuê được chỉ định và kết thúc bằng một đường dẫn gọi chỉ dành cho máy chủ.
X-API-Key: pending_activation_…InstoMediav1# Available only after support activation
export INSTO_MEDIA_TOKEN="issued-after-review"
curl -X POST https://insto.app/v1/resolve \
-H "X-API-Key: $INSTO_MEDIA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'Insto trình bày ba điểm thực tiễn về an toàn Thông tin đăng nhập. Đầu tiên là lưu trữ bí mật phía máy chủ. Bài đánh giá tải xuống sau đó đề cập đến việc không nhúng gói khách hàng. Điểm cuối cùng là 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
Đối với thao tác Giải quyết, Insto bắt đầu với việc phát hiện nguồn. Đánh giá tải xuống của nó kết hợp điều đó với các định dạng từ một URL đã gửi và kết thúc mà không có đầu ra nào được tạo ra.
/v1/resolvePhạm vi: giải quyết| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
media_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
}Insto trình bày ba điểm thực tiễn cho định danh định dạng. Đầu tiên là giá trị trả về không thay đổi. Đánh giá tải xuống sau đó bao gồm tính khả dụng theo từng liên kết. Điểm cuối cùng là 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
Insto tổ chức việc tạo Công việc xung quanh chuẩn bị không đồng bộ. Đánh giá tải xuống của nó so sánh một yêu cầu HTTP ngắn. Thực thi công nhân có giới hạn vẫn là kiểm tra cuối cùng.
/v1/jobsPhạm vi: công việc| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
media_source | URL HTTPS | Có | Cùng nguồn chuẩn hóa gửi giải quyết. |
media_variant | 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://insto.app/v1/jobs \
-H "X-API-Key: $INSTO_MEDIA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID","media_variant":"18"}'prepare_id.GET /v1/jobs/{prepare_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://insto.app/v1/jobs/PREPARE_ID \
-H "X-API-Key: $INSTO_MEDIA_TOKEN"Trong Insto, chờ đợi ban đầu một giây được thực hiện đầu tiên khi giải thích việc kiểm tra công việc. Đánh giá tải xuống đó tiếp theo với việc giảm tần suất có giới hạn và kết thúc bằng phân phối ký tạm thời.
Những sai lầm có thể dự đoán
Để giải thích Hợp đồng lỗi, Insto phân tách một phong bì không phải 2xx khỏi ID yêu cầu hỗ trợ. Một đánh giá tải xuống cung cấp cách xử lý khách hàng có thể dự đoán cho vị trí riêng của 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
Insto tùy chỉnh giới hạn cuộc gọi cho trường hợp sử dụng hình ảnh-truyền thông và các mạng mà khách hàng được phê duyệt sẽ liên hệ.
- 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.
Đối với truy cập Schema, Insto bắt đầu với kích hoạt trước khi khám phá. Đánh giá tải xuống của nó kết hợp điều đó với xác thực được chỉ định và kết thúc bằng các mẫu yêu cầu đã được ghi chép.
Kích hoạt thông qua hỗ trợ
Phác thảo sản phẩm phương tiện hình ảnh, mức sử dụng hàng tháng dự kiến và loại bài đăng bạn dự định xử lý. Insto chỉ cấp các phạm vi phân tích hoặc chuẩn bị cần thiết và không bao giờ lưu trữ mã thông báo có thể đọc được.
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.