PRODUCTION REST API · v1

Aga difaele tša go fetolwa ka YTSave

Thola URL ya mecha ya setšhaba, kgetha sebopego se se nepagetšego, hlama mošomo wa go se dira ka nako e sa lekanywego gomme o neye mosebedisi wa gago sephetho se se saenegago. Mothopo wa tlhahiso o swanago o šoma weposaete ya YTSave.

YTSaveClientJSON ka HTTPSMešomo ya go se be le nako e teeDitshedimošo tša maemo a itšego

Thoma ka potlako

YTSave e laola mošomi wa API ka go thoma ka go lemoga ditlaleletšo tše di tshegetšwago ke tše di tsentšwego tšhomišong. E latela ka sebaka sa tenant se abetšwego gomme e boloka tsela ya mogopo wa server fela e le ponagatšong.

URL ya Moagihttps://ytsave.app

NetefatšoX-API-Key: ys_live_…

Profayela ya morekiYTSaveClient

Phetolo ya 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"}'

Go hlalosa polokego ya Credential, YTSave e aroganya polokego ya sephiri ya server-side go se tsenye bundle ya moreki. Rekoto ya bopaki ga e fe logi tša setšhaba goba diphuthego sebaka sa yona.

Thibela kgokagano

YTSave e laola tshepedišo ya Tharollo ka go thoma ka go lemoga mohlodi wa go lemoga. E latela ka diforomo tša URL ye e romilwego gomme ga e boloke diphetho tše di bopilwego ka pono.

POST/v1/resolveSekala: rarolla

Mafelo	Mofuta	Ya hlokega	Tlhalošo
`url`	HTTPS URL	Ee	Leqephe la mešomo ya setšhaba goba la ba dumelletšwego go sekaseka.
`tenant`	letšatši	Aowa	Setša sa mošomi se abetšwego. Ka mehla ga se tsenyege.

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

Go hlalosa Mošomiši wa Foromo, YTSave e aroganya boleng bjo bo bošwa bja go bo fa go tšwa go go hwetšagala ga kgokaganyo ka nngwe. Rekoto ya bopaki ga e fe leina la boleng leo le akanywago sebaka sa lona.

Hlama le go latela mošomo wa go download-a

Bakeng sa tlhamišo ya Mošomo, YTSave e thoma ka tlaleletšo ya go se be le nako ye telele. Rekoto ya yona ya bopaki e kopanya seo le kopo ye kgolo ya HTTP gomme e fela ka tshepedišo ya mošomiši yo a lekanyeditšwego.

POST/v1/jobsSekala: mešomo

Mafelo	Mofuta	Ya hlokega	Tlhalošo
`url`	HTTPS URL	Ee	Mokgwa o tee wa mohlodi wo o tseneletšwego go rarolla.
`format_id`	letšatši	Ee	ID ye e nepagetšego go tšwa karabong ya go rarolla.
`tenant`	letšatši	Aowa	Setša sa mošomi se abetšwego. Ka mehla ga se tsenyege.

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 E amogetšweBoloka job_id.

2Boemo bja PollGET /v1/jobs/{job_id} ka senotlolo se tee.

3E lokileBula URL ya go Khoasolla ye e saenwego.

Boemo	Phetolelo	Tiragalo ya moreki
`queued`	O amogetšwe ka gare ga molapo wo o lekanyeditšwego.	Botsa gape ka go khutla morago.
`extracting`	Go ntšha gape tshedimošo ya mohlodi goba tsela.	Tšwela pele ka go botšiša.
`processing`	Go download-a, go remux-a goba go kopanya.	Bontšha kgolo ya seva.
`ready`	Go Khoasolla go saenwego go a hwetšagala.	Romela URL go mosebedisi.
`failed`	Phoso ye e hlophilwego ya terminal.	Bala `error_code`. Lekola gape ge o eletšwe fela.
`expired`	Sephetho sa nako ye e lekanyeditšwego se ile sa tloswa.	Hlama mošomo o moswa.

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

YTSave e dira gore go hlahloba mešomo ya Job go be bonolo. Letlakala le thoma ka go leta ka motsotso wa go thoma, le sepela go ya go go thibela ka mo go lekanyeditšwego, gomme le bolela ka go hlakilego pego ya nako ye e saenwego ya pego.

Diphoso tše di ka lebelelwago

Bakeng sa konteraka ya Phoso, YTSave e hlahloba sephuthelo sa envelope se se seng sa 2xx pele ga ID ya kgopelo ya thušo. Rekoto ye ya bopaki gape e hlakanya ka go hlakilego taolo ya moreki ye e lebelelago pele.

{
  "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	Kutollo ya tlwaelo	Tiragalo
400	URL ye e fošagetšego, mmele goba fomo ye e sa hwetšegago.	Lokolla kopo. Thola gape bakeng sa diforomo.
401	Senotlolo se se nago gona, se fosa, se fedile goba se na le seemo se se fapanego.	Hlahloba setifikeiti sa lehlakore la seva.
403	Molao wa moagi goba mohlodi o ganetše kopo.	O se ke wa fetoša leano. Ikopanye le tšehetso.
404	Mošomo wo o sa tsebego goba wo o fetilego nako ya ona.	Hlama mošomo o moswa ge go swanetše.
429	Kgwetšo ya kgopelo goba mošomo wo o šomago e fihleletšwe.	Tlotla `retry_after_seconds`.
503	Mola/bokgoni goba godimo ga yona ga se gona ka nakwana.	Leketša gape ka go ema ka go oketša le go phaphatha.

Konteraka ya tshepedišo

YTSave e fana ka tekanyo ya tšhomišo le ge e amogetšwe go šireletša mothomi wa API le ditirelo tša mešongwana ya godimo.

Šomiša mantšu a kopanyo a idempotent gomme o se thome mešomo ye e phepetšego bakeng sa go toba ga mosebedi yo mongwe.
Boloka metadata ya go rarolla ka pela, efela kamehla o swara di-URL tša go laola tše di saenwego bjalo ka tše di felego.
Šomiša go khutša ka lebelo la go oketša ka go fapafapana le go phaphatha 429, 503 le diphoso tše di ka lekwa gape.
Šoma fela ka media ya setšhaba goba media ye o dumelletšwego go e fihlelela. DRM le taolo ya phihlelelo ga di fetišwe.
Boloka dikopo tša ID le dikopo tša mošomo ka gare ga direkoto tša tshepedišo tša poraivete. O se ke wa ngwala di-URL tše di rometšwego ka go se hlokomele.

YTSave e laola phihlelelo ya Schema ka go thoma ka go lemoga tshepetšo pele o hlahloba. E latela ka netefatšo ye e abetšwego gomme e boloka mekgwa ya dikopo tše di ngwadilwego ka pono. Tlhahisoleseding ya OpenAPI

PHOFOLO-EHLOHILEGO YA MOSEBETSI

Kopa senotlolo sa gago sa API

Ngwala mothusi wa API, tekanyetšo ya dikopo tša kgwedi le dinyakwa tša setšhaba tše tšeelwago. YTSave e lekola ge go rarolla, go romela mošomo goba ka bobedi go amogetšega pele ga go fetoša senotlolo seo se bonagalago ka lekgetlo le tee.

Kopa phihlelelo ya API Dikgoro di lekanyeditswe go mohireng, di ka kgutlisiwa morago gomme di abiwa ka foromo ya Kgokagano. Diskripiti tša go sa tsebjwago ga di kgone go phethagatša mošomo wa mošomiši wa go laola go lata.