ئىشلەپچىقىرىش REST API · v1

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 مۇلازىمېتىر تەرەپتىكى مەخپىي ساقلاشنى خېرىدار تەرەپ بۈلەك قوشۇشتىن ئايرىدۇ. دەلىل خاتىرىسى ئومۇمىي خاتىرە ياكى ساقلاش ئورنىغا ئۆزىگە خاس ئورۇن بېرىدۇ.

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"}'
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 Schema غا كىرىشنى ئالدى بىلەن قوزغىتىشنى ئېنىقلاپ باشقۇرىدۇ. ئۇ تەيىنلەنگەن دەلىللەشنى ئەگىشىدۇ ۋە تەلەپ شەكىللىرىنى كۆرۈنۈشتە ساقلايدۇ. OpenAPI نىشانى

ئاپپاراتچى تەكشۈرگەن كىرىش

API ئاچقۇچىڭىزنى تەلەپ قىلىڭ

API ئىستېمالچىسى، ئۇنىڭ ئايلىق تەلەپ تەخمىنى ۋە قوللايدىغان پلاتفورما تەلەپلىرىنى ھۆججەتلەڭ. YTSave بىر قېتىم كۆرۈلگەن ئاچقۇچنى چىقىرىشتىن بۇرۇن ھەل قىلىش، ئىش تەقدىم قىلىش ياكى ئىككىسىنىڭمۇ ئاساسلىقلىقىنى تەكشۈرىدۇ.

API غا كىرىشنى تەلەپ قىلىش كۇنۇپكىلار ئىجارىدار دائىرىسىگە چەكلىك، قايتۇرۇپ ئېلىشقا بولىدۇ ۋە ئالاقە فورمىسى ئارقىلىق بېرىلىدۇ. نامەلۇم سىنارىيەلەر چۈشۈرگۈچ ئىشلىرىنى ئىجرا قىلالمايدۇ.