ထုတ်လုပ်မှု REST API · ဗားရှင်း ၁

YTSave ဖြင့် ဒေါင်းလုဒ်များ တည်ဆောက်ပါ

အများပြည်သူမီဒီယာ URL ကို ဖြေရှင်းပြီး တိကျသောဖော်မတ်ကို ရွေးချယ်၊ အဆင့်လိုက်အလုပ်တစ်ခု ဖန်တီးပြီး လက်မှတ်ထိုးထားသောရလဒ်ကို သင့်အသုံးပြုသူထံ ပေးပို့ပါ။ ထိုတူညီသော ကန့်သတ်ထားသောထုတ်လုပ်မှုလိုင်းသည် YTSave ဝက်ဘ်ဆိုဒ်ကို လှုံ့ဆော်ပေးသည်။

YTSaveClientHTTPS မှတဆင့် JSONအချိန်မညီ အလုပ်များအကန့်အသတ်ထားသော အတည်ပြုချက်များ
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"}'

Credential လုံခြုံမှုကိုရှင်းပြရန်အတွက် YTSave သည် server-side လျှို့ဝှက်သိုလှောင်မှုကို client bundle မထည့်သွင်းခြင်းမှ ခွဲထုတ်ထားသည်။ သက်သေမှတ်တမ်းသည် အများပြည်သူမှတ်တမ်းများ သို့မဟုတ် repository များကို မည်သည့်နေရာမှ မပေးပါ။

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
}

Format အမှတ်အသားဖော်ပြချက်ကို ရှင်းပြရန် YTSave သည် ပြန်လည်ပေးပို့သော တန်ဖိုးကို per-link ရရှိနိုင်မှုမှ မပြောင်းလဲဘဲ ခွဲထုတ်သည်။ သက်သေမှတ်တမ်းတစ်ခုသည် ခန့်မှန်းထားသော အရည်အသွေး အမှတ်အသားကို မည်သည့်နေရာမှ မပေးပါ။

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"}'
1202 လက်ခံပြီးသိမ်းဆည်းမည် job_id.
2မဲပေးမှုအခြေအနေGET /v1/jobs/{job_id} တူညီသော key ဖြင့်။
3ပြင်ဆင်ပြီးလက်မှတ်ထိုးထားသော ဒေါင်းလုပ် URL ကို ဖွင့်ပါ။
အခြေအနေအဓိပ္ပါယ်ဖောက်သည် လုပ်ဆောင်ချက်
queuedကန့်သတ်ထားသော စာရင်းသို့ ဝင်ရောက်ခွင့်ပြုသည်။နောက်ပြန်ဆုတ်ပြီး ထပ်မံမဲပေးပါ။
extractingအရင်းအမြစ် မီတာဒေတာ သို့မဟုတ် လမ်းကြောင်းကို ပြန်လည်အသစ်ပြုလုပ်နေသည်။ဆက်လက်မဲပေးခြင်း။
processingဒေါင်းလုပ်ဆွဲခြင်း၊ ပြန်လည်ဖွဲ့စည်းခြင်း သို့မဟုတ် ပေါင်းစည်းခြင်း။ဆာဗာတိုးတက်မှုကို ပြပါ။
readyလက်မှတ်ထိုးထားသော ဒေါင်းလုပ် ရနိုင်ပါသည်။အသုံးပြုသူထံ URL ပို့ပါ။
failedTerminal ဖွဲ့စည်းထားသော အမှား။ဖတ်မည် 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ပျောက်ဆုံးနေသော၊ မမှန်ကန်သော၊ သက်တမ်းကုန်ဆုံးသွားသော သို့မဟုတ် မှားယွင်းသော အာဏာအကွာအဝေးသော key။ဆာဗာဘက်မှ အတည်ပြုချက်ကို စစ်ဆေးပါ။
403ငွေရှင်းသူ သို့မဟုတ် အရင်းအမြစ် မူဝါဒက တောင်းဆိုမှုကို ငြင်းပယ်လိုက်သည်။မူဝါဒကို ကျော်လွှားမထားပါနှင့်။ အထောက်အပံ့ကို ဆက်သွယ်ပါ။
404မသိရှိရသေးသော သို့မဟုတ် သက်တမ်းကုန်ဆုံးသွားသော အလုပ်။သင့်တော်လျှင် အလုပ်အသစ်တစ်ခု ဖန်တီးပါ။
429တောင်းဆိုမှု သို့မဟုတ် လုပ်ငန်းလက်ရှိ အကန့်အသတ်ကို ရောက်ရှိပါပြီ။ဂုဏ်ယူခြင်း retry_after_seconds.
503စီစဉ်မှု/စွမ်းဆောင်ရည် သို့မဟုတ် အပေါ်လွှာ ခေတ္တ မရရှိနိုင်ပါ။အဆင့်မြှင့်ပြီး ပြန်ကြိုးစားပါ၊ jitter နှင့်အတူ။
05

စွမ်းဆောင်ရည်စာချုပ်

YTSave သည် API အသုံးပြုသူနှင့် အထက်တန်း မီဒီယာဝန်ဆောင်မှုများကို ကာကွယ်ရန် အတည်ပြုချက်တိုင်းတွင် လည်ပတ်မှု အရေအတွက်ကို ထုတ်ပေးသည်။

YTSave သည် Schema ဝင်ရောက်ခွင့်ကို စတင်ဖော်ထုတ်ခြင်းမှ စတင်ကာ စစ်ဆေးခြင်းအထိ ကိုင်တွယ်သည်။ ထိုနောက် သတ်မှတ်ထားသော အတည်ပြုချက်နှင့် လိုက်နာပြီး တောင်းဆိုမှုပုံစံများကို မြင်ကွင်းတွင် မှတ်တမ်းတင်ထားသည်။ OpenAPI ကိုးကားချက်

အော်ပရေတာ-သုံးသပ်ပြီး ဝင်ရောက်ခွင့်

သင့် API key ကို တောင်းဆိုပါ

API အသုံးပြုသူ၊ ၎င်း၏ လစဉ်တောင်းဆိုမှု ခန့်မှန်းချက်နှင့် ပံ့ပိုးသော ပလက်ဖောင်းလိုအပ်ချက်များကို မှတ်တမ်းတင်ပါ။ YTSave သည် ဖြေရှင်းခြင်း၊ အလုပ်တင်သွင်းခြင်း သို့မဟုတ် နှစ်ခုလုံး တရားဝင်ဖြစ်ကြောင်း သေချာစေရန် တစ်ကြိမ်သာ မြင်နိုင်သော key ထုတ်ပေးမီ ပြန်လည်သုံးသပ်သည်။

API လက်လှမ်းရရှိမှုကို တောင်းဆိုပါ သော့များသည် အငှားရှင်အကွာအဝေးရှိပြီး၊ ပြန်လည်ဖျက်သိမ်းနိုင်ပြီး Contact ဖောင်မှတဆင့် ထုတ်ပေးသည်။ အမည်မသိ စာသားများသည် downloader အလုပ်ကို အကောင်အထည်မဖော်နိုင်ပါ။