PRODUCTION REST API · v1

Haha likopi ka YTSave

Fetolela URL ya media ya setjhaba, kgetha fomate e nepahetseng, theha mosebetsi o sa emeng mme o fe mosebedisi wa hao sephetho se saenweng. Mothamo o tshwanang wa tlhahiso o tsamaisa sebaka sa marang-rang sa YTSave.

YTSaveClientJSON ka HTTPSMesebetsi e sa tsamaeeng ka nako e le 'ngoeMangolo a nang le moeli

Qalo e potlakileng

YTSave e sebetsana le moamoheli oa API ka ho khetholla pele litifikeiti tse ts'ehetsang tse qaliloeng. E latela ka ntlha ea moahi e abetsoeng 'me e boloka tsela ea mohala oa seva feela e le pono.

URL ea Moahihttps://ytsave.app

NetefatsoX-API-Key: ys_live_…

Profil ea morekiYTSaveClient

Mofuta oa 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"}'

Ho hlalosa polokeho ea Credential, YTSave e arohanya polokelo ea lekunutu lehlakoreng la seva ho tloha ho se kenyelletsoeng ho bundle ea moreki. Rekoto ea bopaki ha e fane ka log kapa polokelo ea sechaba e ikemetseng.

Lokisa sehokelo

YTSave e sebetsana le ts'ebetso ea Tharollo ka ho khetholla pele ho fumana mohloli. E latela ka liforomo tse tsoang ho URL e le 'ngoe e rometsoeng 'me ha e boloke tlhahiso e entsoeng ka boithaopo ponong.

POST/v1/resolveSebaka: rarolla

Sefahleho	Mofuta	E hlokahala	Tlhaloso
`url`	HTTPS URL	E	Leqephe la sechaba kapa la tumello ea media bakeng sa ho sekaseka.
`tenant`	ketane	Che	Sebaka sa moahi se abetsoeng. Hangata se tlosoa.

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

Ho hlalosa Moqapi oa Foromo, YTSave e arohanya boleng bo khutlisoang bo sa fetoheng ho tloha ho fumaneha ha sehokelo ka seng. Rekoto ea bopaki ha e fane ka sebaka sa boleng bo hakantsoeng.

Theha 'me u latele mosebetsi oa ho jarolla

Bakeng sa tlhahiso ea Mesebetsi, YTSave e qala ka litokisetso tse sa tsamaeeng ka nako e le 'ngoe. Rekoto ea eona ea bopaki e kopanya seo le kopo e khutšoanyane ea HTTP 'me e fela ka ts'ebetso e lekanyelitsoeng ea mosebeletsi.

POST/v1/jobsSekala: mesebetsi

Sefahleho	Mofuta	E hlokahala	Tlhaloso
`url`	HTTPS URL	E	Mohloli o tšoanang o tloaelehileng o rometsoe ho rarolla.
`format_id`	ketane	E	ID e nepahetseng ho tsoa karabong ea tharollo.
`tenant`	ketane	Che	Sebaka sa moahi se abetsoeng. Hangata se tlosoa.

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

2Boemo ba lipatlisisoGET /v1/jobs/{job_id} ka senotlolo se tšoanang.

3E lokileBula URL ea ho jarolla e saennoeng.

Boemo	Bohlokwa	Tsebo ea moreki
`queued`	E amohetsoe moleng o lekanyelitsoeng.	Botsa hape ka mora ho emisa.
`extracting`	Ho ntlafatsa metadata ea mohloli kapa tsela.	Tsoela pele ho botsa.
`processing`	Ho jarolla, ho fetola kapa ho kopanya.	Bontša tsoelo-pele ea seva.
`ready`	Ho jarolla ho saennoa ho fumaneha.	Romela URL ho mosebedisi.
`failed`	Phoso e hlophisitsoeng ya terminal.	Bala `error_code`. Lekola hape feela ha ho eletsoa.
`expired`	Sephetho sa nakoana se ile sa tloswa.	Theha mosebetsi o mocha.

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

YTSave e etsa hore ho hlahloba mesebetsi ho be bonolo ho e sheba. Leqephe le qala ka ho emela motsotsoana o le mong, le fetela ho ho emisa ka moeli, 'me le bolela ka ho hlaka phepelo e sa tšoarehang e saena.

Liphoso tse ka hakanyetsoang

Bakeng sa konteraka ea Phoso, YTSave e hlahloba sephutheloana se le seng se seng sa 2xx pele ho ID ea kopo ea tšehetso. Rekoto ena ea bopaki e boetse e etsa hore ho sebetsana ha moreki ho be bonolo ho utloahala.

{
  "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 ea moelelo	Tsebo
400	URL e fosahetseng, 'mele kapa sebopeho se sa fumaneheng.	Lokisa kopo. Etsa qeto hape bakeng sa liforomo.
401	Senotlolo se ha se eo, se fosahetse, se felile kapa se na le moeli o fosahetseng.	Hlahloba setifikeiti sa seva.
403	Mokhanni kapa leano la mohloli le lahlile kopo.	Se ke oa feta molao. Ikopanye le tšehetso.
404	Mosebetsi o sa tsejoeng kapa o felileng.	Theha mosebetsi o mocha haeba ho loketse.
429	Kopo kapa moeli oa mosebetsi o sebetsang o fihletsoe.	Hlompha `retry_after_seconds`.
503	Mokete/bokhoni kapa phallo e ka holimo ha e fumanehe nakoana.	Lekola hape ka morao ka keketseho le phaphamalo.

Konteraka ea ts'ebetso

YTSave e fana ka tekanyo ea ts'ebetso ka tumello e 'ngoe le e 'ngoe ho sireletsa moreki oa API le lits'ebeletso tsa media tsa pele.

Sebelisa mantsoe a kopanetsoeng a kopo 'me o se ke wa qala mesebetsi e tshekaletseng bakeng sa tobetso e tshwanang ya mosebedisi.
Boloka metadata ea tharollo ka nako e khuts'oane, empa kamehla o tšoare li-URL tsa download tse saennoeng e le tse nang le nako ea ho fela.
Sebelisa ho khutlisa ka potlako ho lekanyelitsoeng ka ho phaphatha bakeng sa 429, 503 le liphoso tse ka phetoang.
Sebetsa feela media e bulehileng kapa media eo u lumelletsoeng ho e fihlella. DRM le taolo ea phihlello ha li fetoloe.
Boloka li-ID tsa likopo le li-ID tsa mesebetsi ka har'a di-log tsa ts'ebetso tsa poraefete. Se ke oa ngola li-URL tse rometsoeng ka ntle ho hlokahala.

YTSave e sebetsana le phihlello ea Schema ka ho khetholla pele ho qala pele ho hlahloba. E latela ka netefatso e abetsoeng 'me e boloka mebala ea likopo e ngotsoeng e le pono. Tlhahisoleseling ea OpenAPI

PHIHLELO E HLATSOILOE KE MOSEBETSI

Kopa senotlolo sa hau sa API

Ngola mosebedisi wa API, tekanyo ya dikopo tsa kgwedi le ditlhoko tsa sethala tse tshehetsweng. YTSave e lekola hore na ho rarolla, ho kenya mosebetsi kapa ka bobedi ho loketse pele e fana ka senotlolo se bonahalang hang.

Kopa phihlello ea API Linotlolo li lekanyelitsoe ho beng ba tsona, li ka tlosoa 'me li fanoa ka foromo ea Khokahano. Likhoutu tse sa tsejoeng ha li khone ho phethahatsa mosebetsi oa motlatsi.