ИШЛАБ CHIQARISH REST API · v1

YTSave bilan yuklab olishlarni qurish

Jamoat media URL manzilini hal qiling, aniq formatni tanlang, asinxron ish yarating va imzolangan natijani foydalanuvchingizga taqdim eting. Xuddi shu bog'langan ishlab chiqarish liniyasi YTSave veb-saytini quvvatlaydi.

YTSaveClientHTTPS орқали JSONАсинхрон ишларМинтақага оид ишончномалар

Тезкор бошланиш

YTSave API-xostni avval qo'llab-quvvatlash faollashtirilgan ma'lumotlarni aniqlash orqali boshqaradi. U tayinlangan ijarachining oxirgi nuqtasi bilan kuzatib boradi va faqat serverga chaqiruv yo'lini ko'rishda saqlaydi.

Ижарачи URL'сиhttps://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"}'

Ta'riflash uchun Credential xavfsizligi, YTSave server tomonidagi maxfiy saqlashni hech qanday mijoz paketini joylashtirishdan ajratadi. Bir dalil yozuvi hech qanday jamoat jurnallari yoki omborxonalari o'z o'rnini beradi.

Уланишни ҳал қилиш

YTSave manba aniqlashni birinchi aniqlash orqali hal qilish operatsiyasini boshqaradi. U bir topshirilgan URL manzilidan formatlar bilan kuzatib boradi va ko'rishda hech qanday ixtiro qilingan chiqishlarni saqlamaydi.

ПОСТ/v1/resolveМинтақа: ҳал қилиш

Майдон	Тури	Талаб қилинади	Таърифи
`url`	HTTPS URL	Ҳа	Таҳлил қилиш учун жамоат ёки ваколатли ОАВ саҳифаси.
`tenant`	сатр	Йўқ	Belgilanadigan ijarachi domeni. Odatda o'tkazib yuboriladi.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Format identifikatorini tushuntirish uchun, YTSave qaytarib berilgan qiymatni o'zgartirmasdan per-link mavjudligidan ajratadi. Bir dalil yozuvi hech qanday taxmin qilingan sifat yorlig'iga o'z joyini beradi.

Yuklab olish ishini yarating va kuzatib boring

Ish yaratish uchun YTSave asynchronous tayyorgarlik bilan boshlanadi. Uning dalillar yozuvi bu qisqa HTTP so'rovi bilan juftlashadi va chegaralangan ishchi ijrosi bilan tugaydi.

ПОСТ/v1/jobsКўрсаткич: иш ўринлари

Майдон	Тури	Талаб қилинади	Таърифи
`url`	HTTPS URL	Ҳа	Hal qilish uchun bir xil normallashtirilgan manba taqdim etildi.
`format_id`	сатр	Ҳа	Aniq ID resolve javobidan olingan.
`tenant`	сатр	Йўқ	Belgilanadigan ijarachi domeni. Odatda o'tkazib yuboriladi.

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ТайёрИмзоланган yuklab olish URL-манзилини ochish.

Ҳолат	Маъноси	Мижознинг ҳаракати
`queued`	Cheklangan navbatga qabul qilindi.	Овоз беришни яна бир бор ортга қайтариш билан.
`extracting`	Manba metama'lumotlari yoki yo‘l yangilanmoqda.	Сўровнома ўтказишни давом эттиринг.
`processing`	Юклаб олиш, ремукс ёки бирлаштириш.	Сервернинг ишлаш жараёнини кўрсатиш.
`ready`	Имзоланган юклаб олиш мавжуд.	URL-манзилни фойдаланувчига юборинг.
`failed`	Terminalda tuzilgan xato.	Ўқиш `error_code`. Faqat tavsiya qilinganda qayta urinib ko'ring.
`expired`	Вақтинчалик чиқариб ташланди.	Янги иш ўрни яратиш.

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave Job so'rovnomasini skanerlashni osonlashtiradi. Sahifa bir soniyalik dastlabki kutishdan boshlanadi, qoplangan orqaga qaytishga o'tadi va vaqtinchalik imzolangan etkazib berishni aniq ko'rsatadi.

Тахмин қилинадиган хатолар

Xatolik shartnomasi uchun YTSave bir qo'llab-quvvatlash so'rovi ID dan oldin bir non-2xx konvertni tekshiradi. Bu dalillar yozuvi ham oldindan aytib bo'lmaydigan mijozni boshqarish aniq bo'ladi.

{
  "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, танаси ёки мавжуд бўлмаган формат.	So'rovni to'g'rilang. Formatlar uchun qayta hal qiling.
401	Yo'qolgan, noto'g'ri, muddati o'tgan yoki noto'g'ri doiradagi kalit.	Server tomonidagi autentifikatsiyani tekshiring.
403	Ijaraчи yoki manba siyosati so'rovni rad etdi.	Siyosatni chetlab o'tmang. Qo'llab-quvvatlash bilan bog'laning.
404	Noma'lum yoki muddati o'tgan ish.	Agar kerak bo‘lsa, yangi ish yaratish.
429	So‘rov yoki faol ish limiti oshdi.	Иззат `retry_after_seconds`.
503	Навбат/қувват ёки юқорига вақтинчалик етиб бўлмайди.	Eksponensial orqaga chekinish va tebranish bilan qayta urinib ko'ring.

Ишлаб чиқариш шартномаси

YTSave API iste'molchisini va yuqoriga qarab media xizmatlarini himoya qilish uchun har bir tasdiqlash bilan operatsion kvota chiqaradi.

idempotent dastur mantiqidan foydalaning va hech qachon bir xil foydalanuvchi bosimi uchun takrorlanadigan ishlarni boshlamang.
Кэш метамаълумотларни қисқача ҳал қилади, lekin har doim imzolangan yuklab olish URL-manzillarini tugaydigan deb hisoblaydi.
Jitter bilan chegaralangan eksponensial orqaga chekinishni qo'llang 429, 503 ва қайта уриниш хатолари.
Faqat jamoatchilik mediasi yoki siz kirish huquqiga ega bo'lgan mediani qayta ishlash. DRM va kirish nazorati chetlab o'tmaydi.
So'rov ID va ish IDlarini shaxsiy operatsion jurnallarda saqlang. Berilgan URL manzillarini keraksiz ravishda yozmang.

YTSave birinchi navbatda tadqiqotdan oldin faollashtirishni aniqlash orqali Schema kirish bilan shug'ullanadi. U tayinlangan autentifikatsiya bilan kuzatib boradi va hujjatlashtirilgan so'rov shakllarini ko'rishda saqlaydi. OpenAPI бўйича кўрсатмалар

ОПЕРАТОР ТАКРОРЛАГАН КИРУВ

API калитингизни сўранг

API iste'molchisini, uning oylik so'rov taxminini va qo'llab-quvvatlanadigan platforma talablarini hujjatlashtiring. YTSave kalitni bir marta ko'rinadigan qilib chiqarishdan oldin, yechim, ish topshirish yoki ikkalasi ham asosli ekanligini ko'rib chiqadi.

API га киришни сўранг Kalitlar ijarachi doirasida, bekor qilinishi mumkin va aloqa shakli orqali beriladi Anonim sxemalar yuklab oluvchi ishini bajarolmaydi.