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 مۇلازىمېتىر تەرەپتىكى مەخپىي ساقلاشنى خېرىدار تەرەپ بۈلەك قوشۇشتىن ئايرىدۇ. دەلىل خاتىرىسى ئومۇمىي خاتىرە ياكى ساقلاش ئورنىغا ئۆزىگە خاس ئورۇن بېرىدۇ.
ئۇلانمىنى ھەل قىلىش
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
}فورمات بەلگىلەشنى چۈشەندۈرۈش ئۈچۈن، YTSave قايتۇرۇلغان قىممەتنى ئۇلانما-بويىچە بار بولۇشتىن ئۆزگەرتىلمەي ئايرىدۇ. بىر دەلىل خاتىرىسى پەرەز قىلىنغان سۈپەت بەلگىسىگە ئۆزىگە خاس ئورۇن بەرمەيدۇ.
چۈشۈرۈش ۋەزىپىسى قۇرۇش ۋە ئەگىشىش
ئىش قۇرۇش ئۈچۈن، 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} شۇ ئوخشاش ئاچقۇچ بىلەن.| ھالىتى | مەنا | مۇلازىمەتچى ھەرىكىتى |
|---|---|---|
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 ئىش پۈتۈرۈشنى ئاسان سۈرۈشتۈرۈش ئۈچۈن تەمىنلەيدۇ. بەت بىر سېكۇنتلۇق باشلانغۇچ كۈتۈش بىلەن باشلىنىدۇ، چەكلىك قايتا سىناشقا ئۆتىدۇ، ۋە ۋاقىتلىق ئىمزالىق يەتكۈزۈشنى ئېنىق بىلدۈرىدۇ.
ئالدىن كۆرۈلەلەيدىغان خاتالىقلار
خاتالىق كېلىشىمى ئۈچۈن، 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 | نۆۋەتتە قۇرۇلۇش/ساقلاش ياكى ئۈستۈنكى تەرەپ ۋاقىتلىق مەۋجۇت ئەمەس. | ئېكسپونېنتسىيال قايتا سىناش ۋە چۈشكۈنلۈك بىلەن قايتا سىناش. |
ئىجرا شەرتنامىسى
YTSave ھەر بىر ماقۇللاشتا API ئىستېمالچىسى ۋە ئۈستۈنكى مەدىيا مۇلازىمەتلىرىنى قوغداش ئۈچۈن بىر ئىجرا چەكلىمىسى بېرىدۇ.
- ئېنىق نۇسخىلىق قوللىنىش مەنتىقىسىنى ئىشلىتىپ، بىر خىل ئىشنى قايتا باشلاشتىن ساقلىنىڭ.
- كېشنى قىسقا ۋاقىتلىق ھەل قىلىڭ، ئەمما ئىمزالىق چۈشۈرۈش URLلىرىنى ھەر دائىم مۇددەت ئۆتكەن دەپ قارىڭ.
- جىتتېر بىلەن چەكلىك ئېكسپونېنتىيال قايتا سىناشنى ئىشلىتىش
429,503ۋە قايتا سىناشقا بولىدىغان خاتالىقلار. - پەقەت ئاممىۋى مەدىيا ياكى سىزگە رۇخسەت قىلىنغان مەدىيانىلا ئىشلەڭ. DRM ۋە كىرىش كونتروللىرى ئايلاندۇرۇلمايدۇ.
- ئىلتىماس IDلىرى ۋە ئىش IDلىرىنى شەخسىي ئىجرا خاتىرىلىرىدا ساقلاڭ. تەقدىم قىلىنغان URLلارنى زۆرۈر بولمىغانچە خاتىرلىمەڭ.
YTSave Schema غا كىرىشنى ئالدى بىلەن قوزغىتىشنى ئېنىقلاپ باشقۇرىدۇ. ئۇ تەيىنلەنگەن دەلىللەشنى ئەگىشىدۇ ۋە تەلەپ شەكىللىرىنى كۆرۈنۈشتە ساقلايدۇ. OpenAPI نىشانى
API ئاچقۇچىڭىزنى تەلەپ قىلىڭ
API ئىستېمالچىسى، ئۇنىڭ ئايلىق تەلەپ تەخمىنى ۋە قوللايدىغان پلاتفورما تەلەپلىرىنى ھۆججەتلەڭ. YTSave بىر قېتىم كۆرۈلگەن ئاچقۇچنى چىقىرىشتىن بۇرۇن ھەل قىلىش، ئىش تەقدىم قىلىش ياكى ئىككىسىنىڭمۇ ئاساسلىقلىقىنى تەكشۈرىدۇ.
API غا كىرىشنى تەلەپ قىلىش كۇنۇپكىلار ئىجارىدار دائىرىسىگە چەكلىك، قايتۇرۇپ ئېلىشقا بولىدۇ ۋە ئالاقە فورمىسى ئارقىلىق بېرىلىدۇ. نامەلۇم سىنارىيەلەر چۈشۈرگۈچ ئىشلىرىنى ئىجرا قىلالمايدۇ.