PRODUCTION REST API · v1

Сохтани зеркашиҳо бо YTSave

URL-и васоити оммаро ҳал кунед, формати дақиқро интихоб кунед, кори асинхронӣ эҷод кунед ва натиҷаи имзошударо ба корбари худ супоред. Ҳамон хатти истеҳсоли маҳдудшуда вебсайти YTSave-ро таъмин мекунад.

YTSaveClientJSON тавассути HTTPSВазифаҳои асинхронӣИҷозатномаҳои маҳдудшуда

Оғози зуд

YTSave бо API хостро бо муайян кардани аввалин шаҳодатномаҳои фаъолшудаи дастгирӣ идора мекунад. Он бо нуқтаи ниҳоии иҷорагир таъиншуда идома медиҳад ва роҳи занги танҳо сервериро дар назар нигоҳ медорад.

URL-и иҷоранишинhttps://ytsave.app

Санҷиши эътиборX-API-Key: ys_live_…

Профили муштарӣYTSaveClient

Нусхаи APIv1

# 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-и пешниҳодшуда идома медиҳад ва дар намоиш ҳеҷ баромади ихтироъшударо нигоҳ намедорад.

ПОСТ/v1/resolveҲудуд: ҳал кардан

Майдони	Навиштан	Мутлақо зарур	Тавсиф
`url`	URL-и HTTPS	Бале	Саҳифаи расмӣ ё иҷозатдодашудаи ВАО барои таҳлил.
`tenant`	сатр	Не	Доменҳои иҷорагиро таъин карданд. Одатан нодида гирифта мешавад.

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

Барои шарҳи шиносномаи Формат, YTSave арзиши баргардонидашударо бе тағйир аз дастрасии ҳар як пайванд ҷудо мекунад. Сабти далел ба ягон тамғаи тахминии сифат ҷойи алоҳида намедиҳад.

Эҷод ва пайгирии кори зеркашӣ

Барои эҷоди Кор, YTSave бо омодасозии асинхронӣ оғоз мекунад. Сабти далел онро бо дархости кӯтоҳи HTTP ҷуфт мекунад ва бо иҷрои маҳдуди коргар анҷом меёбад.

ПОСТ/v1/jobsҲудуд: корҳо

Майдони	Навиштан	Мутлақо зарур	Тавсиф
`url`	URL-и HTTPS	Бале	Ҳамон манбаи муқарраршуда барои ҳал кардан пешниҳод шуд.
`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-ро пеш аз ID-и дархости дастгирӣ санҷида мегирад. Ин сабти далел инчунин идоракунии пешгӯинашавандаи муштариро равшан мекунад.

{
  "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-ҳои зеркашии имзошударо ҳамчун мӯҳлатгузар ҳисоб кунед.
Истифодаи бозгашти экспоненсиалӣ бо jitter барои 429, 503 ва хатогиҳои такроршаванда.
Танҳо бо медиаи оммавӣ ё медиае, ки шумо иҷозат доред, коркард кунед. DRM ва назоратҳои дастрасӣ гузаронида намешаванд.
ID-ҳои дархост ва ID-ҳои корро дар журналҳои амалиётии хусусӣ нигоҳ доред. URL-ҳои пешниҳодшударо бебаҳра ворид накунед.

YTSave дастрасии Schema-ро бо муайян кардани фаъолсозӣ пеш аз таҳқиқ идора мекунад. Он бо тасдиқи таъиншуда идома медиҳад ва шаклҳои дархостҳои ҳуҷҷатшударо дар назар нигоҳ медорад. Маълумоти OpenAPI

Дастрасӣ бо баррасии оператор

Дархости калиди API-и шумо

Истеъмолкунандаи API, тахмини дархостҳои моҳона ва талаботи платформаи дастгиришударо ҳуҷҷатгузорӣ кунед. YTSave пеш аз додани калиди якдафъаинаи намоён баррасӣ мекунад, ки оё ҳал кардан, ирсоли кор ё ҳарду дуруст аст.

Дархости дастрасӣ ба API Калидҳо барои иҷорагирон маҳдуданд, баргардонида мешаванд ва тавассути шакли тамос дода мешаванд. Скриптҳои анонимӣ наметавонанд кори зеркашандаро иҷро кунанд.