ӨНҮКТҮРҮҮ REST API · v1

YTSave менен жүктөөлөрдү түзүү

Жалпы медиа URL дарегин чечип, так форматты тандап, асинхрондук жумуш түзүп, кол коюлган натыйжаны колдонуучуга тапшырыңыз. Ошол эле чектелген өндүрүш линиясы YTSave веб-сайтында иштейт.

YTSaveClientHTTPS аркылуу JSONАсинхрондук тапшырмаларЧектелген күбөлүктөр

Ыкчам баштоо

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 сервер тараптагы сыр сактоону кардар пакетине киргизүүдөн бөлүп турат. Далил жазуусу коомдук журналдарга же репозиторийлерге өзүнчө орун бербейт.

Сылтаманы чечүү

YTSave Чечүү операциясын биринчи булак аныктоону аныктоо менен иштетет. Ал бир берилген 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 кайтарылган маанини шилтемеге жараша өзгөрүүсүз бөлүп көрсөтөт. Далил жазуусу болжолдонгон сапат белгисине өзүнчө орун бербейт.

Жүктөө тапшырмасын түзүү жана аны көзөмөлдөө

Иш түзүү үчүн, 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"}'

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 жумушту сурам кылууну оңой кылат. Баракча бир секунддук баштапкы күтүүдөн баштап, чектелген артка чегинүүгө өтөт жана убактылуу кол коюлган жеткирүүнү так билдирет.

Болжолдонгон каталар

Ката келишими үчүн, 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 Схемага кирүүнү биринчи активдештирүүнү аныктоо менен иштетет. Андан кийин дайындалган аутентификацияны аткарат жана документтелген сурам формаларын көзөмөлдөйт. OpenAPI шилтемеси

ОПЕРАТОР ТЕКШИРГЕН КИРИҮҮ

API ачкычыңызды сураныз

API колдонуучусун, анын айлык сурам санын жана колдоого алынган платформа талаптарын документтештир. YTSave чечим кабыл алуу, жумуш тапшырмасын берүү же экөөнүн тең негиздүүлүгүн бир жолу көрүнгөн ачкычты чыгаруудан мурун карайт.

APIге кирүү суранычы Түймөлөр ижарачыга тиешелүү, кайтарылып алынышы мүмкүн жана Байланыш формасы аркылуу берилет. Анонимдүү скрипттер жүктөөчү ишин аткара албайт.