د تولید REST API · v1

د YTSave سره ډاونلوډونه جوړ کړئ

عامه رسنۍ URL حل کړئ، دقیق بڼه وټاکئ، یو غیر همزمانه دنده جوړه کړئ او لاسلیک شوی پایله خپل کارونکي ته وسپارئ. هماغه محدود تولیدي پایپ لاین د YTSave ویب پاڼه ځواک ورکوي.

YTSaveClientJSON د HTTPS له لارېغیر همغږي دندېمحدود شوي اسناد
01

چټک پیل

YTSave د API کوربه د ملاتړ فعال شوي اسنادو په پیژندلو سره اداره کوي. دا د ټاکل شوي کرایه دار پای ټکی تعقیبوي او یوازې د سرور زنګ وهلو لاره په لید کې ساتي.

د کرایې URLhttps://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"}'

د اعتبار خونديتوب د تشريح لپاره، YTSave د سرور اړخ پټ ذخيره د هېڅ کلاینت بڼې د ننه کولو څخه جلا کوي. د شواهدو ریکارډ هېڅ عامه لاګونه يا ذخیرې ته خپله ځانګړې ځای نه ورکوي.

02

یو لینک حل کړئ

YTSave د حل عملیات د سرچینې کشف په پیژندلو سره پیلوي. دا د یو وړاندې شوي URL څخه فارمیټونه تعقیبوي او هیڅ اختراعي محصول په لید کې نه ساتي.

POST/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 غوښتنې سره جوړه وي او د محدود کارګر اجرا سره پای ته رسیږي.

POST/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"}'
1۲۰۲ منل شویخوندي کول 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 د سکیمې لاسرسی د فعالولو پیژندلو سره پیلوي مخکې له دې چې سپړنه وکړي. دا د ټاکل شوي تصدیق تعقیبوي او د غوښتنې مستند شوي بڼې په لید کې ساتي. د OpenAPI حواله

د عامل لخوا بیاکتل شوی لاسرسی

خپل API کیلي غوښتنه وکړئ

د API مصرف کوونکي، د میاشتني غوښتنې اټکل او ملاتړ شوي پلیټ فارم اړتیاوې مستند کړئ. YTSave بیاکتنه کوي چې ایا حل، دنده سپارل یا دواړه توجیه شوي دي مخکې له دې چې یو ځل لیدل شوی کیلي صادر کړي.

د API لاسرسي غوښتنه کیلي د کرایه دار په کچه دي، بیرته اخیستونکي دي او د اړیکې فورم له لارې صادریږي. ناشناس سکریپټونه د ډاونلوډر کار نشي اجرا کولی.