https://ytsave.appYTSave арқылы жүктеулерді құру
Қоғамдық медиа URL-ін шешіңіз, дәл форматты таңдаңыз, асинхронды жұмыс жасаңыз және қол қойылған нәтижені пайдаланушыңызға беріңіз. Сол шектелген өндіріс желісі YTSave веб-сайтын да қамтамасыз етеді.
YTSaveClientHTTPS арқылы JSONАсинхронды тапсырмаларАуқымды куәліктер
01
Жылдам бастау
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 сервер жағындағы құпия сақтау мен клиенттік бандлды енгізбеуді бөледі. Дәлел жазбасы ешқандай қоғамдық журналдар немесе репозиторийлерге өз орнын бермейді.
02
Сілтемені шешу
YTSave Resolve операциясын бастапқы анықтауды анықтаудан бастайды. Ол бір ұсынылған URL-ден форматтарды жалғастырады және ойдан шығарылған шығыстарды көріністе сақтамайды.
POST
/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 қайтарылған мәнді сілтеме бойынша қолжетімділіктен өзгертпей бөледі. Дәлел жазбасы болжамды сапа белгісіне жеке орын бермейді.
03
Жүктеу тапсырмасын жасау және бақылау
Жұмыс құру үшін, YTSave асинхронды дайындаудан бастайды. Оның дәлел жазбасы оны қысқа HTTP сұрауымен жұптайды және шектелген жұмысшы орындалуымен аяқталады.
POST
/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 Жұмыс сұрауын оңай сканерлеуге мүмкіндік береді. Бет бір секундтық бастапқы күтуімен басталады, шектелген артқа шегінуге өтеді және уақытша қол қойылған жеткізуді анық көрсетеді.
04
Болжамды қателер
Қате келісімшарт үшін YTSave қолдау сұрау идентификаторынан бұрын бір 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 тұтынушысы мен жоғары деңгейдегі медиа қызметтерін қорғау үшін.
- Идемпотентті қолданба логикасын қолданыңыз және бірдей пайдаланушы басуы үшін қайталанатын тапсырмаларды ешқашан бастамаңыз.
- Кэште метадеректерді қысқа уақытқа шешіңіз, бірақ қол қойылған жүктеу URL-дерін әрқашан мерзімі өткен деп қараңыз.
- Жиі ауытқулармен шектелген экспоненциалды артқа шегінуді пайдалану
429,503және қайта әрекет етуге болатын қателер. - Тек қоғамдық медиа немесе сізге қолжетімділік берілген медианы өңдеңіз. DRM және қолжетімділік бақылаулары айналып өтілмейді.
- Сұрау идентификаторлары мен жұмыс идентификаторларын жеке операциялық журналдарда сақтаңыз. Жіберілген URL мекенжайларын қажетсіз тіркемеңіз.
YTSave Схемаға қолжетімділікті алдымен белсендіруді анықтау арқылы басқарады. Ол тағайындалған аутентификациямен жалғасып, сұрау үлгілерін құжаттап көреді. OpenAPI анықтамалығы
API кілтіңізді сұрау
API тұтынушысын, оның ай сайынғы сұраныс болжамын және қолдау көрсетілетін платформа талаптарын құжаттаңыз. YTSave бір рет көрінетін кілтті шығармас бұрын шешім қабылдау, жұмыс тапсыру немесе екеуі де негізделгенін қарастырады.
API қолжетімділігін сұрау Кілттер жалға алушыға бағытталған, қайтаруға болатын және Байланыс формасы арқылы беріледі. Анонимді сценарийлер жүктеуші жұмысты орындай алмайды.