PRODUCTION REST API · v1

YTSave менән йөкләүҙәр төҙөү

Йәмәғәт мәғлүмәт URL-ын асығыҙ, төгәл формат һайлағыҙ, асинхрон эш булдырығыҙ һәм ҡулланыусығыҙға ҡултамғаланған һөҙөмтәне тапшырығыҙ. Шул уҡ бәйләнгән етештереү линияһы YTSave веб-сайтын тәьмин итә.

YTSaveClientHTTPS аша JSONАсинхрон эштәрСығымланған танытмалар

Тиҙ башлау

YTSave API хостын тәүҙә ярҙамға активлаштырылған танытмаларҙы билдәләү менән эшләй. Унан һуң тәғәйенләнгән арендасы осрағын эйәрә һәм серверға ғына мөрәжәғәт итеү юлын күренештә тота.

Ҡунаҡ 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"}'

Креденциал хәүефһеҙлеген аңлатыу өсөн, YTSave сервер яғының серле һаҡлауын клиент пакетына индереүҙән айыра. Доказательство яҙмаһы бер ниндәй ҙә асыҡ журналдар йәки репозиторийҙар өсөн үҙ урынын бирмәй.

Һылтанманы хәл итеү

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 кире ҡайтарылған ҡиммәтте сылтама буйынса мөмкинлектән үҙгәртмәй айыра. Доказательство яҙмаһы фаразланған сифат билдәһенә үҙ урынын бирмәй.

Йөкләү эшен булдырыу һәм күҙәтеү

Эш булдырыу өсөн 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 ярҙам һорау идентификаторы алдынан бер 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-ға рөхсәт һорау Төптәр аренда буйынса сикләнгән, кире алынырға мөмкин һәм Контакт формасы аша бирелә. Аноним сценарийҙар йөкләүсе эшен башҡара алмай.