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

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

برای توضیح ایمنی اعتبارنامه، YTSave ذخیره‌سازی مخفی سمت سرور را از عدم جاسازی بسته کلاینت جدا می‌کند. یک رکورد شواهد هیچ لاگ یا مخزن عمومی را جایگاه خاصی نمی‌دهد.

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

برای توضیح شناسه فرمت، YTSave مقدار بازگردانده شده را بدون تغییر از دسترسی هر لینک جدا می‌کند. یک رکورد شواهد هیچ برچسب کیفیت حدسی را جایگاه خاصی نمی‌دهد.

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

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave باعث می شود که Job polling به راحتی اسکن شود.صفحه با یک ثانیه انتظار اولیه شروع می شود ، به 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 های ارسال شده را بدون نیاز به آن لاگ نکنید.

YTSave دسترسی Schema را با شناسایی ابتدایی فعال سازی قبل از کاوش مدیریت می کند.این با احراز هویت اختصاص داده شده دنبال می شود و اشکال درخواست مستند را در نظر می گیرد. مرجع OpenAPI