PRODUCTION REST API · v1

Buufata YTSave waliin ijaari

URL miidiyaa ummataa hiiki, foormaaticha sirrii filadhu, hojii asinkroonii uumi, bu'aa mallattoo qabuu fayyadamaa keetiif kenni. Pipaayinii oomisha daangaa qabu walfakkaatu YTSave marsariitii ni deeggara.

YTSaveClientJSON irra HTTPSHojiiwwan AsynchronousEyyama daangessuu

Jalqaba ariifachiisaa

YTSave tajaajila API host to'achuuf dursee ragaa deeggarsa hojiirra oolu adda baasa. Sana booda bakka bu'aa tenant ramadame hordofa, karaa waamicha server-qofa ilaala.

URL kireessaahttps://ytsave.app

MirkaneessaX-API-Key: ys_live_…

Galmee maamilaaYTSaveClient

Gosa 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"}'

Nageenya Ragaa Eenyummaa ibsuuf, YTSave kuusaa dhoksaa tajaajila irraa adda baasa, kuusaa maamilaa keessatti hin galchitu. Ragaan ragaa kun galmee ummataa yookaan kuusaa dhuunfaa hin kennu.

Liinkii hiiki

YTSave hojii Furmaata jalqaba adda baasuudhaan jalqaba. Itti aansuun foormaatota URL tokko irraa dhiyaatan hordofa, fi baafata uumame hin mul'isu.

POST/v1/resolveDaangaa: hiikuu

Dirree	Gosa	Dirqama	Ibsa
`url`	URL HTTPS	Eeyyee	Fuula miidiyaa ummataa yookiin hayyamame xiinxaluuf.
`tenant`	tarree	Lakkoofsa	Daangaa abbaa qabeenyaa ramadame. Yeroo baay'ee hin dabalamu.

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

Ibsa Eenyummaa Foomaatichaa ibsuuf, YTSave gatii deebifame gara argamni linkii tokko tokko hin jijjiiramin adda baasa. Ragaan ragaa tokko mallattoo qulqullina tilmaamame ofii isaa hin kennu.

Hojii buufata uumi fi hordofi

Hojii uumuuf, YTSave qophii asinkroonii jalqaba. Galmee ragaa isaa waliin gaaffii HTTP gabaabaa walitti hidha, xumura immoo hojjataa daangaa qabuu raawwata.

POST/v1/jobsDaangaa: hojii

Dirree	Gosa	Dirqama	Ibsa
`url`	URL HTTPS	Eeyyee	Madda walfakkaatu sirnaan dhiyaate furmaataaf.
`format_id`	tarree	Eeyyee	ID sirrii deebii hiikuu irraa.
`tenant`	tarree	Lakkoofsa	Daangaa abbaa qabeenyaa ramadame. Yeroo baay'ee hin dabalamu.

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 FudhateOlkaa'i job_id.

2Haala sagantaaGET /v1/jobs/{job_id} kiyyoo walfakkaatu waliin.

3Qophaa'eURL buufata mallatteeffame banaa.

Haala	Hiika	Hojii Maamilaa
`queued`	Qarqara tarree daangeffameetti seename.	Deebii deebisuu yeroo dheeraa waliin.
`extracting`	Madda metadata yookaan karaa haaromsaa jira.	Filannoo itti fufu.
`processing`	Buufachaa, remux gochaa yookiin walitti makaa jira.	Hojii tajaajilaa agarsiisi.
`ready`	Buufata mallatteeffame ni argama.	URL gara fayyadamaa ergi.
`failed`	Dogoggora sirna terminalii.	Dubbisi `error_code`. Deebisanii yaali yeroo qajeelfame qofaa.
`expired`	Baafata yeroo gabaabaa haqame.	Hojii haaraa uumi.

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

YTSave hojii filannoo salphisuuf salphaa taasisa. Fuulli tokkoo-lakkaddaa eegumsaa jalqabaa waliin jalqaba, deebi'ee hir'isuuf ce'aa, fi ergama mallattoo yeroo muraasa ifatti ibsa.

Dogoggora dursee tilmaamamu

Rakkoo waliigalaa irratti, YTSave ergaa 2xx hin taane tokko dura ID gaafii deeggarsaa ilaala. Ragaan kunis too'annoo abbaa fayyadamaa ifa godha.

{
  "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	Hiika Waliigalaa	Sochii
400	URL sirrii miti, qaama ykn faayilii hin argamne.	Gaaffii sirreessi. Gara foormaatotaatti deebii kenni.
401	Furmaatni dhabe, sirrii miti, xumurame yookaan furtuu daangaa dogoggoraa.	Mirkaneessi ragaa tajaajilaa tajaajilaa.
403	Seera kireeffataa yookiin madda gaaffii didde.	Seera hin darbinaa. Deeggarsa qunnamaa.
404	Hojii hin beekamne yookiin yeroo isaa xumurame.	Hojii haaraa yoo barbaachisaa ta'e uumi.
429	Gaaffii yookaan daangaa hojii hojjatamaa ga'eera.	Kabaja `retry_after_seconds`.
503	Tarree/baay'ina yookaan olka'aa yeroo gabaabaa hin jirre.	Deebisuu yeroo dabalaa fi jeeqama waliin.

Waliigaltee hojii

YTSave hayyama tokko tokko waliin qixa hojii kennaaf, kunis fayyadamaa API fi tajaajiloota miidiyaa ol'aanaa eeguuf.

Loogii idempotentii fayyadami, hojiiwwan wal fakkaatan fayyadamaa tokkoof hin jalqabiin.
Metadaataa hiikuu yeroo gabaabaa, garuu URLwwan buufata mallatteeffaman yeroo hunda akka xumuraman ilaalaa.
Fayyadami deebi'ee dacha'uu daangaa qabuu fi jijiiramaaf 429, 503 fi dogoggora deebisanii yaaluu danda'an.
Meediyyaa ummataa qofa yookaan kan siif hayyamame qofa hojjechi. DRM fi to'annoo seera seensaa hin darbamne.
IDwwan gaafannaa fi IDwwan hojii galmee hojii dhuunfaa keessatti eegi. URLwwan dhiyaatan hin galmeessin yoo hin barbaachisne.

YTSave too'annoo Schema dursee hojiirra oolmaa adda baasuudhaan to'ata. Sana booda mirkaneessa ramadame hordofa, akkasumas foormaatota gaafii galmee keessa jiran ilaala. Waliigala OpenAPI

GALMEELEE HOJII-TO'ATAME

Furmaatni API kee gaafadhu

Fayyadamaa API, tilmaama gaaffii ji'a ji'aan isaa fi barbaachisummaa platform deeggaramu galmeessi. YTSave hiikuu, dhiheessuu hojii yookiin lamaan isaanii mirkaneessa dura furtuu yeroo tokko mul'atu kennu.

Gaaffii seensa API Furmaatni furtuuwwan bakka kireeffataa irratti xiyyeeffatan, deebisamuu danda'an, fi Foomii Quunnamtii irratti kennaman. Barreeffamoonni maqaa dhoksan hojii buufataa raawwachuu hin danda'an.