ПРОИЗВОДСТВО REST API · v1

YTSave пултару тӗп

Пĕлтерĕшлĕ публичнăй медиа URL-не чĕнтер, тĕплĕ форматне суйла, асинхронлă ĕç йĕрки туса, ҫырулă резулътатне усă кӗнекке пар. Пӗрехилӗн чикленнӗ пӗлтерӗшле пӗлтерӗшле производство конвейере YTSave сайчне те пуҫтарса ҫӗнтерет.

YTSaveClientHTTPS пӗр JSONАсинхронне пултарПĕр çыннисемпе пĕрлешĕвĕнсем

Пӗрле пӗрлӗ

YTSave API хостне малтанах пурнӑҫлантарнӑ вӗҫӗпе сӑнласа, активленӑн тивӗҫлӗ credential-ӗсем пур-и манӑштар. Унан хыҫҫӑн тенантӑн çӗвӗр endpoint-не тупса, серверсем валли гене ылташланнӑ call path-не куçарса пырат.

Тенант 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 safety тыттине аңлатма пек, YTSave сервер енчи шăхсăх сакланавне клиент bundle кĕртесрен уйăрта. Evidence record публичный logs тата repositories пулма алăк хушнă хыҫҫăн пĕрре те темелле мар.

Сылтамӑр пӗрле

YTSave Resolve операцине вӗҫӗмрен source detection-не палӑртса утӑм çине илсе çитертет. Вӑл пӗрӗнӗҫтернӗ 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
}

Format identifier сăнласа каласан, YTSave кăтарнă хакăя вĕртенеле пĕрлех тăрăх йăварăлĕн кайтарнă хакăя улшăнмасăр тухатат. Evidence record пысăк хакăлăх ячĕне хăйне тӗлĕшле çуртне памаст.

Пытару вӑхӑтне тӑрӑхӗсемпе пытару

Job çĕнтерӳшĕ валли, YTSave асинхронлӑ хатӗрленӳпе пуҫланат. Унӑн тӗллевлӗк/шӑхӑт пултарулӑх укҫине пӗр кӗске HTTP ыйтӑвӗпе пӗтӗртет те, чикленнӗ worker ӑшне кӗртсе пӗтерет.

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 Job pollingă kăṭsa pălă. Stranitsa 1 sekunda dăvraçă çĕnčĕ te avărtă, çĕnĕ cap backoff çine kuçă, teta temporallă signed delivery-şă kĕrtĕn pĕlteret.

Пĕрлĕхĕр хăйĕрĕсем

Error contract валли, YTSave 2xx-тан нимĕн те мар envelope-не support request ID умĕн тӑрӑшса tikşerĕ. Кунта тӗплӗх хӑтлантарулла client handling-не те кӑтартса парать.

{
  "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-пайдаланăрăнă та upstairs media çĕнӗлӗхĕсене сыхлас тесе, кашни хыпарланăвӗпе операци кво́тине парать.

Идемпотентлă приложение логикине усă кала, пĕрхавăтçă ача чикенĕн тĕлĕнче икĕ пӗркĕнĕш ҫумне те пуҫламан.
Кэшра метаданнăсене пысăк тытса пырать, анчах пурнăҫ тавраш кăларнă скачать URL-не пĕтрĕнекен тесе шутла.
Пырăнмасть exponential backoff с jitter пурăнатăп 429, 503 ҫӗршывсемпе пытару хӗвеллӗхӗн.
Ӗҫе кӗртӗн пӗрнех хальлӗхри медианӑмпа я медианӑмпа, кӑна хӑвӑрта уҫса кӗрме хӑтлантарнине ытлашши пайлантарса. DRM тата кӗрме чиклемӗшсем уҫӑлмаҫҫӗ.
Request IDsem tата job IDsem şıvǎrmar operatsi logĕsĕnче çyra. Submitted URLsem asărmar logla.

YTSave Schema çyrăvăna çunatăna çuralăkh çine palărtatnă activation çine palărtatnă çumăshă çine palărtatnă first identifying activation before exploration. Исемленӗ аутентификаципе пӗрле пыра, те ӑнлантарнӑ ыйтӑв ҫӗрлевӗшӗн формӑсене шута илет. OpenAPI сӑвӑсем

ОПЕРАТОР-ПРОВЕРЕННЫЙ ДОСТУП

API ключĕн пĕр çинчен

API хэрэглені, аның айлык запрослар фаразын татаӳрласа та, ярӑмлӑ платформа талӑпӑшӗсене кӑтартӑр. YTSave резолюци, job submission ятӑнсем те, иккӗшӗ те тӑратса, хӗрле кӗрӗк ачӑ тӗллевне параймӗенчен алласа тӳрлет.

API пĕрлешĕвĕн пырăнмасть Пӗрлехсем tenant-чӗнче пулнӑ, тӑратма пулать тата Contact формӑсем урлӑ панӑ. Аноним скриптсем downloader-ӑн ӗҫне атқарма пултараймаҫҫӗ.