https://ytsave.appد YTSave سره ډاونلوډونه جوړ کړئ
عامه رسنۍ URL حل کړئ، دقیق بڼه وټاکئ، یو غیر همزمانه دنده جوړه کړئ او لاسلیک شوی پایله خپل کارونکي ته وسپارئ. هماغه محدود تولیدي پایپ لاین د YTSave ویب پاڼه ځواک ورکوي.
چټک پیل
YTSave د API کوربه د ملاتړ فعال شوي اسنادو په پیژندلو سره اداره کوي. دا د ټاکل شوي کرایه دار پای ټکی تعقیبوي او یوازې د سرور زنګ وهلو لاره په لید کې ساتي.
X-API-Key: ys_live_…YTSaveClientv1# 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 د سرور اړخ پټ ذخيره د هېڅ کلاینت بڼې د ننه کولو څخه جلا کوي. د شواهدو ریکارډ هېڅ عامه لاګونه يا ذخیرې ته خپله ځانګړې ځای نه ورکوي.
یو لینک حل کړئ
YTSave د حل عملیات د سرچینې کشف په پیژندلو سره پیلوي. دا د یو وړاندې شوي URL څخه فارمیټونه تعقیبوي او هیڅ اختراعي محصول په لید کې نه ساتي.
/v1/resolveسکوپ: حل کول| میدان | ډول | ضروري | تفصیل |
|---|---|---|---|
url | HTTPS URL | هو | د تحلیل لپاره عام یا مجاز رسنۍ پاڼه |
tenant | سټینګ | نه | ټاکل شوی کرایه دار ډومین. معمولا له پامه غورځول کیږي. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}د بڼه پیژندونکي تشریح کولو لپاره، YTSave بیرته راستول شوی ارزښت د هر لینک شتون څخه بې بدله جلا کوي. د شواهدو ریکارډ هیڅ اټکل شوی کیفیت لیبل خپل ځای نه ورکوي.
ډاونلوډ دنده جوړه کړه او تعقیب یې کړه
د دندې جوړولو لپاره، YTSave د غیر همغږي چمتووالي سره پیل کوي. د دې د شواهدو ریکارډ دا د لنډ HTTP غوښتنې سره جوړه وي او د محدود کارګر اجرا سره پای ته رسیږي.
/v1/jobsحدود: دندې| میدان | ډول | ضروري | تفصیل |
|---|---|---|---|
url | HTTPS URL | هو | هماغه عادي شوی سرچینه د حل لپاره وړاندې شوې. |
format_id | سټینګ | هو | د حل ځواب څخه دقیق ID. |
tenant | سټینګ | نه | ټاکل شوی کرایه دار ډومین. معمولا له پامه غورځول کیږي. |
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"}'job_id.GET /v1/jobs/{job_id} د ورته کیلي سره.| حالت | معنی | د پیرودونکي عمل |
|---|---|---|
queued | په محدود شوي قطار کې منل شوی. | بیا د شاتګ سره رایه ورکړئ. |
extracting | د سرچینې میټاډاټا یا لاره تازه کیږي. | پوښتنې ته دوام ورکړئ. |
processing | ډاونلوډ کول، بیا تنظیمول یا یوځای کول. | د سرور پرمختګ ښکاره کړئ. |
ready | لاسلیک شوی ډاونلوډ شتون لري. | URL کارونکي ته واستوئ. |
failed | د پای ټکي جوړښت تېروتنه. | لوستل error_code. یوازې هغه وخت بیا هڅه وکړئ کله چې مشوره درکړل شي. |
expired | موقتي محصول لرې شو. | نوې دنده جوړه کړئ. |
curl https://ytsave.app/v1/jobs/JOB_ID \
-H "X-API-Key: $YTSAVE_API_KEY"YTSave د دندې پلټنه اسانه کوي. پاڼه د یوې ثانیې لومړني انتظار سره پیل کیږي، بیا محدود شوي بیک آف ته ځي، او په واضح ډول د موقتي لاسلیک شوي تحویلي یادونه کوي.
قابل وړاندوینه تېروتنې
د تېروتنې قرارداد لپاره، YTSave د ملاتړ غوښتنې ID مخکې یو غیر 2xx لفافه چک کوي. دا شواهد ثبت هم د پیرودونکي د وړاندوینې وړ چلند روښانه کوي.
{
"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 | معمولي معنی | عمل |
|---|---|---|
| 400 | ناسم URL، بدن یا نشتون بڼه. | درخواست سم کړئ. د بېرته غوښتنې لپاره بیا حل کړئ. |
| 401 | کلي ورک، ناسم، ختم شوی یا د غلطې ساحې کلي. | د سرور اړخ تصدیق وګورئ. |
| 403 | کرایه دار یا د سرچینې پالیسي غوښتنه رد کړه. | پالیسي مه تېروئ. له ملاتړ سره اړیکه ونیسئ. |
| 404 | نامعلوم یا ختم شوی دنده. | که مناسب وي نو نوی دنده جوړه کړئ. |
| 429 | د غوښتنې یا فعالې دندې حد ته رسیدلی. | عزت retry_after_seconds. |
| 503 | قطار/ظرفیت یا پورته جریان موقتي نه شتون لري. | د زیاتېدونکي ځنډ او ګډوډۍ سره بیا هڅه وکړئ. |
عملي قرارداد
YTSave د هر تایید سره یو عملیاتي کوټا صادروي ترڅو د API مصرف کوونکي او پورته رسنیو خدماتو ساتنه وکړي.
- د ایډیمپټینټ غوښتنلیک منطق وکاروئ او هیڅکله د ورته کارونکي کلیک لپاره تکراري دندې پیل نه کړئ.
- د میټاډاټا لنډمهاله کیش حل کړئ، خو تل د لاسلیک شوي ډاونلوډ URLونه د ختمیدو په توګه وګڼئ.
- د جټر سره تړلی نمایشي بیک آف وکاروئ
429,503او بیا هڅه کیدونکي تېروتنې. - یوازې عامه رسنۍ یا هغه رسنۍ پروسس کړئ چې تاسو ته د لاسرسي اجازه ورکړل شوې وي. د DRM او لاسرسي کنټرولونه نه تېرېږي.
- د غوښتنې ID او دندې ID په شخصي عملیاتي لاګونو کې وساتئ. بې ځایه سپارل شوي URLونه لاګ مه کوئ.
YTSave د سکیمې لاسرسی د فعالولو پیژندلو سره پیلوي مخکې له دې چې سپړنه وکړي. دا د ټاکل شوي تصدیق تعقیبوي او د غوښتنې مستند شوي بڼې په لید کې ساتي. د OpenAPI حواله
خپل API کیلي غوښتنه وکړئ
د API مصرف کوونکي، د میاشتني غوښتنې اټکل او ملاتړ شوي پلیټ فارم اړتیاوې مستند کړئ. YTSave بیاکتنه کوي چې ایا حل، دنده سپارل یا دواړه توجیه شوي دي مخکې له دې چې یو ځل لیدل شوی کیلي صادر کړي.
د API لاسرسي غوښتنه کیلي د کرایه دار په کچه دي، بیرته اخیستونکي دي او د اړیکې فورم له لارې صادریږي. ناشناس سکریپټونه د ډاونلوډر کار نشي اجرا کولی.