PRODUCTION REST API · v1

Aka fa tlase ka YTSave

Thulaganya URL ya media ya setshaba, tlhopha sebopego se se rileng, tlhama tiro e e sa tswang go dirwa mme o neye mosebedisi wa gago sephetho se se saenweng. Mothamo o o lekaneng wa tlhagiso o tshegetsa wepesaete ya YTSave.

YTSaveClientJSON ka HTTPSDitiro tse di sa tsamaelanengDitlhopho tse di lekanyeditsweng

Tshwantshiso ya potlako

YTSave e laola moemedi wa API ka go lemoga pele ditshwanelo tse di tshegetsang tse di tsosolositsoeng. E latela ka ntlha ya moemedi wa tenant yo o abetsweng mme e boloka tsela ya mogopolo wa seva fela e le ponelopele.

URL ya Moagihttps://ytsave.app

Tlhatlhobo ya boitseanapeX-API-Key: ys_live_…

Profilo ya morekiYTSaveClient

Phetolelo 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 tlhalosa polokeho ya Credential, YTSave e aroganya polokelo ya sephiri mo lebaleng la seva go tswa mo go se tsenngwang mo sephuthelong sa moreki. Rekoto ya bosupi ga e fe loga tsa setšhaba kgotsa diphuthego sebaka sa yone.

Tharabolola kgokagano

YTSave e tshwara tshebetso ya Thulaganyo ka go simolola ka go lemoga tshenyo ya mohlodi. E latela ka diforomo tse di tswang mo URL e le nngwe e e rometsweng mme ga e boloke diphetho tse di bopilweng mo ponong.

POST/v1/resolveSekala: rarabolola

Tšhimo	Mofuta	E tlhokega	Tlhaloso
`url`	HTTPS URL	Ee	Leqephe la phatlalatso la setšhaba kgotsa le le dumelwang go sekaseka.
`tenant`	letlha	Nnyaa	Domeine ya moagi e e abetsweng. Gantsi e a tlogelwa.

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

Go tlhalosa Motswedi wa Foromo, YTSave e aroganya boleng jo bo busetsweng jo bo sa fetogeng go tswa mo go go tlhagisetsweng ka kgokelo nngwe le nngwe. Rekoto ya bosupi ga e fe leina la boleng jo bo akanyetsweng sebaka sa yone.

Bopa le go latela tiro ya go laola dikopi

Go Bopa Mosebetsi, YTSave e simolola ka tlhotlheletso e e sa tswang go diragala. Rekoto ya bosupi e kopanya seo le kopo e e khutshwane ya HTTP mme e feleletsa ka tiriso e e lekanyeditsweng ya mošomi.

POST/v1/jobsSekala: ditiro

Tšhimo	Mofuta	E tlhokega	Tlhaloso
`url`	HTTPS URL	Ee	Mokgwa o o tshwanang wa motheo o rometsweng go rarabolola.
`format_id`	letlha	Ee	ID e e nepagetseng go tswa mo karabolong ya go rarabolola.
`tenant`	letlha	Nnyaa	Domeine ya moagi e e abetsweng. Gantsi e a tlogelwa.

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 amogetsweBoloka job_id.

2Boemo jwa PollGET /v1/jobs/{job_id} ka senotlolo se se tshwanang.

3TlhophilweBula URL ya go tsenya e e saenetsweng.

Boemo	Kakaretso	Tiro ya moreki
`queued`	A amogetswe mo lenaaneng le le lekanyeditsweng.	Botsa gape ka go ema morago.
`extracting`	Go tsosolosa tshedimosetso ya mohlodi kgotsa tsela.	Tsamaisa go botsa.
`processing`	Go tsenya, go fetola kgotsa go kopanya.	Bontsha kgatelopele ya seva.
`ready`	Go tsenya go saenetswe go a bonala.	Romela URL mo mothong yo o dirisang.
`failed`	Phoso e e rulagantsweng ya Terminal.	Bala `error_code`. Lekola gape fela fa go eletswile.
`expired`	Tlhahiso ya nako e e fedileng e ne ya tloswa.	Bopa tiro e ntšhwa.

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

YTSave e dira gore go batlisisa mešomo go nne motlhofo go sekasekwa. Letlhakore le simolola ka go emela motsotso o le mongwe, le fetela mo go go emeng ka nako e e lekanyeditsweng, mme le supa sentle gore go na le phatlalatso ya nako e e saenweng.

Diphoso tse di ka lebelelwang

Mo konterakeng ya Phoso, YTSave e lebelela sephuthelo sa non-2xx pele ga ID ya kopo ya tshegetso. Rekoto eno ya bosupi gape e dira gore go tlhokomelwe ga moreki go nne ga tlhaloganyo.

{
  "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	Kakaretso ya tlhaloso	Tiro
400	URL e e sa siamang, mmele kgotsa sebopego se se sa bonalang.	Lebaela kopo. Tlhatlhoba gape ka mekgwa.
401	Senotlolo se se tlhokegileng, se se sa siamang, se se fedileng kgotsa se se nang le seemo se se fapanego.	Lekola ditshupetso tsa moletlo wa seva.
403	Molao wa moagi kgotsa wa mohlodi o ganeditse kopo.	O se ka wa feta melao. Ikopanye le tshegetso.
404	Mošomo o sa itsiweng goba o fedile.	Dira tiro e ntšha fa go siametse.
429	Kopo kgotsa moedi wa tiro e e dirang o fitlhetse mo go feteletseng.	Tlotla `retry_after_seconds`.
503	Mola/ bokgoni kgotsa godimo ga metsi ga gona ka nakwana.	Lekola gape ka go tsosolosa ka go oketsega le go phaphatha.

Konteraka e e dirang

YTSave e abela tekanyetso ya tiriso ka kelotlhoko nngwe le nngwe go sireletsa mothusi wa API le ditirelo tsa media tse di kwa godimo.

Dirisa melao ya tshebediso e e sa fetogeng mme o seka wa simolola ditiro tse di tshwanelang gape mo go tsamaelanang le go tobetsa ga mosebedisi o le mongwe.
Boloka metadata ya go rarabolola ka nakwana, mme o nne o lebelela di-URL tsa go tsenya tse di saenngwang jaaka di felela.
Dirisa go emisa ka nako e e oketsegileng e e lekanyeditsweng le go tsenya pharologanyo 429, 503 le diphoso tse di ka boelwang gape.
Dirisa fela media ya setšhaba kgotsa media e o dumelwang go e tsena mo go yone. DRM le taolo ya phihlelelo ga di fetolwe.
Boloka dikopo tsa kopo le dikopo tsa tiro mo dilogong tsa tiriso tse di ikemetseng. O se ka wa kwala di-URL tse di rometsweng ka go sa tlhokafale.

YTSave e tsamaisa phihlelelo ya Schema ka go lemoga tshimologo pele ga go sekaseka. E latela ka go abela boitshepho mme e boloka ditlhaka tsa dikopo tse di kwadilweng mo ponelopeleng. Mokwalo wa OpenAPI

PHOLOLO E TLHOPHILWE KE MOSEBEDISI

Kopa senotlolo sa gago sa API

Tlhalosa moreki wa API, tekanyetso ya dikopo tsa ngwaga le ditlhoko tsa sethala tse di tshegetsweng. YTSave e sekaseka gore a go rarabololwa, go romelwa ga tiro kgotsa bobedi bo a dumaletswe pele go fano key e e bonalang gangwe fela.

Kopa phihlelelo ya API Dikgato di amana le moagi, di ka tsosolosiwa mme di abiwa ka foromo ya Kgokagano. Ditshekatsheko tse di sa itseng ga di kgone go dira tiro ya mo tsenyi wa dikopi.