پيداوار REST API · v1

YTSave سان ڊائونلوڊ ٺاهيو

هڪ عوامي ميڊيا URL کي حل ڪريو، صحيح فارميٽ چونڊيو، هڪ غير هم وقتي ڪم ٺاهيو ۽ دستخط ٿيل نتيجو پنهنجي صارف کي ڏيو. ساڳيو محدود پيداوار وارو پائپ لائن YTSave ويب سائيٽ کي طاقت ڏئي ٿو.

YTSaveClientHTTPS تي JSONغير هم وقت ساز نوڪريونمحدود سندون
01

جلدي شروع

YTSave API ميزبان کي پهريان سپورٽ-فعال ٿيل سندن جي سڃاڻپ سان سنڀالي ٿو. اهو مقرر ڪيل ٽيننٽ اينڊ پوائنٽ سان جاري رکي ٿو ۽ سرور-صرف ڪال رستي کي نظر ۾ رکي ٿو.

ڪرائي دار جو يو آر ايلhttps://ytsave.app
توثيقX-API-Key: ys_live_…
ڪلائنٽ پروفائلYTSaveClient
API ورزنv1
# 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 سرور-پاسي جي رازدار اسٽوريج کي ڪلائنٽ بَنڊل ايمبيڊنگ کان الڳ ڪري ٿو. هڪ ثبوت رڪارڊ ڪنهن به عوامي لاگز يا ريزپوزيٽريز کي پنهنجو جاءِ نٿو ڏئي.

02

لنڪ حل ڪريو

YTSave حل ڪرڻ واري آپريشن کي پهرين ذريعن جي سڃاڻپ سان سنڀالي ٿو. اهو هڪ جمع ڪيل URL مان فارميٽس جي پيروي ڪري ٿو ۽ ڏسڻ ۾ ڪو به ٺهيل آئوٽ پٽ نٿو رکي.

پوسٽ/v1/resolveاسڪوپ: حل ڪريو
ميدانقسمضروريوضاحت
urlHTTPS URLهاتجزيو ڪرڻ لاءِ عوامي يا مجاز ميڊيا صفحو
tenantاسٽرنگنهمقرر ڪيل ڪرائي دار ڊومين. عام طور تي ڇڏي ڏنو ويندو آهي.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

فارميٽ سڃاڻپ ڪندڙ کي سمجهائڻ لاءِ، YTSave واپس ڪيل قيمت کي هر لنڪ جي دستيابي کان بغير تبديل ڪيل الڳ ڪري ٿو. هڪ ثبوت رڪارڊ ڪنهن به اندازي واري معيار ليبل کي پنهنجو جاءِ نٿو ڏئي.

03

ڊائونلوڊ جو ڪم ٺاهيو ۽ ان جي پيروي ڪريو

نوڪري ٺاهڻ لاءِ، YTSave غير هم وقت ساز تياري سان شروع ڪري ٿو. ان جو ثبوت رڪارڊ ان کي هڪ مختصر HTTP درخواست سان جوڙي ٿو ۽ محدود ورڪر جي عملداري سان ختم ڪري ٿو.

پوسٽ/v1/jobsحدود: نوڪريون
ميدانقسمضروريوضاحت
urlHTTPS 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"}'
1202 منظور ٿيلمحفوظ ڪريو job_id.
2راءِ شماري جي حالتGET /v1/jobs/{job_id} ساڳئي ڪنجي سان.
3تياردستخط ٿيل ڊائونلوڊ URL کوليو.
حالتمعنيٰگراهڪ جي ڪارروائي
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 نوڪري پولنگ کي آسان بڻائي ٿو. صفحو هڪ سيڪنڊ جي ابتدائي انتظار سان شروع ٿئي ٿو، پوءِ محدود بئڪ آف ڏانهن وڃي ٿو، ۽ عارضي صحيح ٿيل پهچائڻ کي واضح طور بيان ڪري ٿو.

04

متوقع غلطيون

غلطی معاهدي لاءِ، 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قطار/گنجائش يا اپ اسٽريم عارضي طور غير دستياب آهي.ايڪسپونينشل بيڪ آف ۽ جٽر سان ٻيهر ڪوشش ڪريو.
05

آپريشنل معاهدو

YTSave هر منظوري سان هڪ آپريشنل ڪوٽا جاري ڪري ٿو ته جيئن API صارف ۽ اپ اسٽريم ميڊيا خدمتن جي حفاظت ڪري سگهجي.

YTSave اسڪيمه رسائي کي پهرين سڃاڻپ ذريعي سنڀالي ٿو، پوءِ ڳولا ڪري ٿو. اهو مقرر ٿيل تصديق سان جاري رکي ٿو ۽ دستاويز ٿيل درخواست جي شڪلن کي نظر ۾ رکي ٿو. اوپن اي پي آءِ حوالو

آپريٽر-جائزو ورتل رسائي

پنهنجو API ڪي درخواست ڪريو

API صارف، ان جي ماهوار درخواست جو اندازو ۽ سپورٽ ڪيل پليٽ فارم جون گهرجون دستاويز ڪريو. YTSave جائزو وٺي ٿو ته حل، نوڪري جمع ڪرائڻ يا ٻئي جائز آهن يا نه، هڪ ڀيرو ڏسڻ واري ڪنجي جاري ڪرڻ کان اڳ.

API رسائي جي درخواست ڪريو چابيون ٽيننٽ-اسڪوپ ٿيل، واپس وٺڻ لائق ۽ رابطو فارم ذريعي جاري ڪيون وڃن ٿيون. گمنام اسڪرپٽ ڊائونلوڊر ڪم انجام نٿا ڏئي سگهن.