بناء التنزيلات مع 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"}'

لشرح سلامة Credential ، يفصل 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 يجعل استطلاع الوظائف سهل المسح الضوئي. تبدأ الصفحة بانتظار أولي لمدة ثانية واحدة ، وتنتقل إلى الركود المقفل ، وتذكر بوضوح التسليم المؤقت الموقع.

{
  "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