ساخت دانلود ها با Insts

# 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"}'

ذخیره‌سازی مخفی سمت سرور نقطه شروع ایمنی مدارک در Insts است. یک میز بازرسی سپس هیچ بسته کلاینت جاسازی شده‌ای را ارائه نمی‌دهد و هیچ گزارش یا مخزن عمومی را توضیح نمی‌دهد.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

مقدار بازگردانده شده بدون تغییر نقطه شروع برای شناسه فرمت در Insts است. یک میز بازرسی سپس در دسترس بودن هر لینک را ارائه می‌دهد و برچسب کیفیت حدس زده شده را توضیح نمی‌دهد.

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"}'

curl https://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

برای Job polling، Insts یک ثانیه انتظار اولیه قبل از کاپ شده backoff را بررسی می کند.این نیمکت بازرسی همچنین تحویل موقت امضا شده را روشن می کند.

{
  "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": "…"
}

• از منطق برنامه idempotent استفاده کنید و هرگز کارهای تکراری را برای همان کلیک کاربر شروع نکنید.
• حافظه نهان به طور خلاصه فراداده را حل می کند، اما همیشه با URL های دانلود امضا شده به عنوان انقضا رفتار می کند.
• استفاده از پس‌انداز نمایی محدود شده با جیتر برای 429, 503 و خطاهای قابل بازنگری
• فقط رسانه های عمومی یا رسانه هایی را که مجاز به دسترسی به آنها هستید پردازش کنید. DRM و کنترل های دسترسی دور زده نمی شوند.
• شناسه های درخواست و شناسه های کار را در لاگ های عملیاتی خصوصی نگه دارید. URL های ارسال شده را بدون نیاز به آن لاگ نکنید.

دسترسی به طرحواره با فعال سازی قبل از کاوش در Insts آغاز می شود.نمای بعدی احراز هویت اختصاص داده شده را پوشش می دهد.صفحه اشکال درخواست مستند را قابل مشاهده نگه می دارد.