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 သည် server-side လျှို့ဝှက်သိုလှောင်မှုကို client bundle မထည့်သွင်းခြင်းမှ ခွဲထုတ်ထားသည်။ သက်သေမှတ်တမ်းသည် အများပြည်သူမှတ်တမ်းများ သို့မဟုတ် repository များကို မည်သည့်နေရာမှ မပေးပါ။
လင့်ခ်ကိုဖြေရှင်းပါ
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
}Format အမှတ်အသားဖော်ပြချက်ကို ရှင်းပြရန် YTSave သည် ပြန်လည်ပေးပို့သော တန်ဖိုးကို per-link ရရှိနိုင်မှုမှ မပြောင်းလဲဘဲ ခွဲထုတ်သည်။ သက်သေမှတ်တမ်းတစ်ခုသည် ခန့်မှန်းထားသော အရည်အသွေး အမှတ်အသားကို မည်သည့်နေရာမှ မပေးပါ။
ဒေါင်းလုပ်အလုပ်တစ်ခု ဖန်တီးပြီး လိုက်နာပါ
အလုပ်ဖန်တီးမှုအတွက် 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} တူညီသော key ဖြင့်။| အခြေအနေ | အဓိပ္ပါယ် | ဖောက်သည် လုပ်ဆောင်ချက် |
|---|---|---|
queued | ကန့်သတ်ထားသော စာရင်းသို့ ဝင်ရောက်ခွင့်ပြုသည်။ | နောက်ပြန်ဆုတ်ပြီး ထပ်မံမဲပေးပါ။ |
extracting | အရင်းအမြစ် မီတာဒေတာ သို့မဟုတ် လမ်းကြောင်းကို ပြန်လည်အသစ်ပြုလုပ်နေသည်။ | ဆက်လက်မဲပေးခြင်း။ |
processing | ဒေါင်းလုပ်ဆွဲခြင်း၊ ပြန်လည်ဖွဲ့စည်းခြင်း သို့မဟုတ် ပေါင်းစည်းခြင်း။ | ဆာဗာတိုးတက်မှုကို ပြပါ။ |
ready | လက်မှတ်ထိုးထားသော ဒေါင်းလုပ် ရနိုင်ပါသည်။ | အသုံးပြုသူထံ URL ပို့ပါ။ |
failed | Terminal ဖွဲ့စည်းထားသော အမှား။ | ဖတ်မည် 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 | ပျောက်ဆုံးနေသော၊ မမှန်ကန်သော၊ သက်တမ်းကုန်ဆုံးသွားသော သို့မဟုတ် မှားယွင်းသော အာဏာအကွာအဝေးသော key။ | ဆာဗာဘက်မှ အတည်ပြုချက်ကို စစ်ဆေးပါ။ |
| 403 | ငွေရှင်းသူ သို့မဟုတ် အရင်းအမြစ် မူဝါဒက တောင်းဆိုမှုကို ငြင်းပယ်လိုက်သည်။ | မူဝါဒကို ကျော်လွှားမထားပါနှင့်။ အထောက်အပံ့ကို ဆက်သွယ်ပါ။ |
| 404 | မသိရှိရသေးသော သို့မဟုတ် သက်တမ်းကုန်ဆုံးသွားသော အလုပ်။ | သင့်တော်လျှင် အလုပ်အသစ်တစ်ခု ဖန်တီးပါ။ |
| 429 | တောင်းဆိုမှု သို့မဟုတ် လုပ်ငန်းလက်ရှိ အကန့်အသတ်ကို ရောက်ရှိပါပြီ။ | ဂုဏ်ယူခြင်း retry_after_seconds. |
| 503 | စီစဉ်မှု/စွမ်းဆောင်ရည် သို့မဟုတ် အပေါ်လွှာ ခေတ္တ မရရှိနိုင်ပါ။ | အဆင့်မြှင့်ပြီး ပြန်ကြိုးစားပါ၊ jitter နှင့်အတူ။ |
စွမ်းဆောင်ရည်စာချုပ်
YTSave သည် API အသုံးပြုသူနှင့် အထက်တန်း မီဒီယာဝန်ဆောင်မှုများကို ကာကွယ်ရန် အတည်ပြုချက်တိုင်းတွင် လည်ပတ်မှု အရေအတွက်ကို ထုတ်ပေးသည်။
- idempotent အက်ပလီကေးရှင်း လိုဂစ်ကို အသုံးပြု၍ တူညီသော အသုံးပြုသူနှိပ်မှုအတွက် မိတ္တူအလုပ်များကို မစတင်ပါနှင့်။
- Cache ဖြေရှင်းမှု metadata ကို အတိုချုပ်ထားသော်လည်း လက်မှတ်ထိုးထားသော ဒေါင်းလုပ် URL များကို အမြဲတမ်း သက်တမ်းကုန်ဆုံးသည့်အဖြစ် ဆက်ဆံပါ။
- Jitter ပါသော ကန့်သတ်ထားသော အဆင့်မြှင့် exponential backoff ကို အသုံးပြုပါ
429,503နှင့် ထပ်မံကြိုးစားနိုင်သော အမှားများ။ - သာမန်လူထုမီဒီယာ သို့မဟုတ် သင်ခွင့်ပြုထားသော မီဒီယာများကိုသာ လုပ်ဆောင်ပါ။ DRM နှင့် ဝင်ရောက်ခွင့်ထိန်းချုပ်မှုများကို ကျော်လွှားမထားပါ။
- တောင်းဆိုမှု ID များနှင့် အလုပ် ID များကို ကိုယ်ပိုင် လုပ်ငန်းမှတ်တမ်းများတွင် ထိန်းသိမ်းပါ။ မလိုအပ်ဘဲ တင်သွင်းထားသော URL များကို မှတ်တမ်းတင်ခြင်း မပြုပါနှင့်။
YTSave သည် Schema ဝင်ရောက်ခွင့်ကို စတင်ဖော်ထုတ်ခြင်းမှ စတင်ကာ စစ်ဆေးခြင်းအထိ ကိုင်တွယ်သည်။ ထိုနောက် သတ်မှတ်ထားသော အတည်ပြုချက်နှင့် လိုက်နာပြီး တောင်းဆိုမှုပုံစံများကို မြင်ကွင်းတွင် မှတ်တမ်းတင်ထားသည်။ OpenAPI ကိုးကားချက်
သင့် API key ကို တောင်းဆိုပါ
API အသုံးပြုသူ၊ ၎င်း၏ လစဉ်တောင်းဆိုမှု ခန့်မှန်းချက်နှင့် ပံ့ပိုးသော ပလက်ဖောင်းလိုအပ်ချက်များကို မှတ်တမ်းတင်ပါ။ YTSave သည် ဖြေရှင်းခြင်း၊ အလုပ်တင်သွင်းခြင်း သို့မဟုတ် နှစ်ခုလုံး တရားဝင်ဖြစ်ကြောင်း သေချာစေရန် တစ်ကြိမ်သာ မြင်နိုင်သော key ထုတ်ပေးမီ ပြန်လည်သုံးသပ်သည်။
API လက်လှမ်းရရှိမှုကို တောင်းဆိုပါ သော့များသည် အငှားရှင်အကွာအဝေးရှိပြီး၊ ပြန်လည်ဖျက်သိမ်းနိုင်ပြီး Contact ဖောင်မှတဆင့် ထုတ်ပေးသည်။ အမည်မသိ စာသားများသည် downloader အလုပ်ကို အကောင်အထည်မဖော်နိုင်ပါ။