https://ytsave.appYTSave سان ڊائونلوڊ ٺاهيو
هڪ عوامي ميڊيا 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"}'Credential حفاظت کي سمجهائڻ لاءِ، 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 صارف ۽ اپ اسٽريم ميڊيا خدمتن جي حفاظت ڪري سگهجي.
- آئيڊيمپوٽنٽ ايپليڪيشن لاجڪ استعمال ڪريو ۽ ڪڏهن به ساڳئي صارف جي ڪلڪ لاءِ نقل نوڪريون شروع نه ڪريو.
- ڪيچ حل ٿيل ميٽا ڊيٽا کي ٿوري دير لاءِ محفوظ ڪريو، پر هميشه صحيح ٿيل ڊائون لوڊ URLs کي ختم ٿيڻ وارو سمجهو.
- جٽر سان گڏ محدود ٿيل ايڪسپونينشل بيڪ آف استعمال ڪريو
429,503۽ ٻيهر ڪوشش لائق غلطيون. - صرف عوامي ميڊيا يا ميڊيا کي پروسيس ڪريو جنهن تائين توهان کي رسائي جي اجازت آهي. DRM ۽ رسائي ڪنٽرولز کي نظرانداز نٿو ڪيو وڃي.
- درخواست ID ۽ نوڪري ID کي ذاتي آپريشنل لاگز ۾ رکو. جمع ڪرايل URL غير ضروري طور تي لاگ نه ڪريو.
YTSave اسڪيمه رسائي کي پهرين سڃاڻپ ذريعي سنڀالي ٿو، پوءِ ڳولا ڪري ٿو. اهو مقرر ٿيل تصديق سان جاري رکي ٿو ۽ دستاويز ٿيل درخواست جي شڪلن کي نظر ۾ رکي ٿو. اوپن اي پي آءِ حوالو
پنهنجو API ڪي درخواست ڪريو
API صارف، ان جي ماهوار درخواست جو اندازو ۽ سپورٽ ڪيل پليٽ فارم جون گهرجون دستاويز ڪريو. YTSave جائزو وٺي ٿو ته حل، نوڪري جمع ڪرائڻ يا ٻئي جائز آهن يا نه، هڪ ڀيرو ڏسڻ واري ڪنجي جاري ڪرڻ کان اڳ.
API رسائي جي درخواست ڪريو چابيون ٽيننٽ-اسڪوپ ٿيل، واپس وٺڻ لائق ۽ رابطو فارم ذريعي جاري ڪيون وڃن ٿيون. گمنام اسڪرپٽ ڊائونلوڊر ڪم انجام نٿا ڏئي سگهن.