REST API PRODUADUR · v1

Sevel an downloaderioù gant YTSave

Diskouez ur URL media foran, dibab ur furmad resis, krouiñ ur raktres asinkron ha reiñ an disoc'h sinet d'ho implijer. An hevelep linenn produiñ a zo war ar bajenn web YTSave.

YTSaveClientJSON dre HTTPSLabourioù asinkronTeulioù gwirioù diabarzh

Kregiñ buan

YTSave a mererezh an API host dre anavezañ kentañ ar c'hredadoù skoazelladek. Heñchet a ra gant ur pennadenn tenant aozet ha dalv an hentenn galv servijer hepken war wel.

Url an den-douehttps://ytsave.app

GwiriañX-API-Key: ys_live_…

Profil ar c'hleientYTSaveClient

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

Evit displegañ surentez ar C'hredadoù, YTSave a zispartia ar stummadur kuzh war ar servijer diouzh ar bundlenn klijent. Ur gontadenn evezhiañ n'en deus ket logoù publik pe lec'hioù enrollañ.

Diskouez ur liamm

YTSave a seven ar c'hinnig Resolve dre anavezañ ar mirdi kentañ. Heuliañ a ra gant ar furmadoù eus ur URL roet ha ne dal ket produioù krouet.

POST/v1/resolveDoare: diskouez

Maez	Seurt	Ret	Deskrivadur
`url`	URL HTTPS	Ya	Pajenn media foran pe aotreet evit anavezout.
`tenant`	lijennañ	Nann	Domani an denezh en em gavet. Alies e vez dilezet.

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

Evit displegañ an anv format, YTSave a zispartiañ ar priz roet hep kemmañ eus ar galloud per-liamm. Ur skrivadeg evedus n'en deus ket ur label kalite mouget e lec'h.

Krouiñ ha heuliañ ur raktres kas da benn

Evit krouiñ labour, YTSave a derou gant prestiñ asyncron. Eñvorenn evezhiañ a zo en ur c'hoari gant ur goulenn HTTP berr ha echuiñ gant oberer serret.

POST/v1/jobsDoare: labourioù

Maez	Seurt	Ret	Deskrivadur
`url`	URL HTTPS	Ya	An hevelep mirdiñ normalet kaset da zisplegañ.
`format_id`	lijennañ	Ya	Un ID resis eus ar respont da zisplegañ.
`tenant`	lijennañ	Nann	Domani an denezh en em gavet. Alies e vez dilezet.

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 AcceptéEnrollañ job_id.

2Stad ar c'houlzadGET /v1/jobs/{job_id} gant an hevelep alc'hwez.

3PrestDigor an URL download sinet.

Stad	Kinnig	Oberenn ar c'hleient
`queued`	Degemeret er navenn bevennet.	Goulenn adarre gant distreiñ.
`extracting`	Adkempenn ar metadonneoù mirdi pe ar hent.	Kenderc'hel da glask.
`processing`	O kas da benn, adstagañ pe unozañ.	Diskouez ar c'hendalc'h servijer.
`ready`	Download sinet a zo dleet.	Kas an URL d'ar implijer.
`failed`	Fazi strujuriet er terminal.	Lenn `error_code`Adkavet nemet ma vez lavaret.
`expired`	Produiñ e-pad un amzer bihan zo bet dilezet.	Krouiñ ur post nevez.

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

YTSave a ra aes ar c'houlenn labour. Kregiñ a ra ar bajenn gant ur c'hortozenn kentañ un eilenn, heuliañ gant ur c'hortozenn serret, ha lavarout a ra sklaer an digeriadenn sinet e-pad un amzer.

Fazioù gouestlet da c'hoari

E-barzh ar c'hontrakt fazi, YTSave a wiria un enveloper n'eo ket 2xx a-raok ur c'hod goulenn skoazell. Ar restr eñvorennoù-se a ra an diskoulm evit ar c'hliant.

{
  "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	Kement-mañ a dalvoudegezh	Obererezh
400	URL direizh, korf pe furmad dianav.	Rekiañ ar goulenn. Adkavout evit ar furmskridoù.
401	Kleñved, direizh, echu pe klemm direizh.	Gwiriñ ar c'hredenn server-side.
403	Polisi an tenant pe ar c'horf-skouer enebet ar goulenn.	Na ziskouez ket ar politik. Kit e darempred gant ar skoazell.
404	Labour dianav pe echu.	Krouiñ ur raktres nevez ma'z eo reizh.
429	Limit ar goulenn pe ar c'huzul labour en ober bet tapet.	Anavezañ `retry_after_seconds`.
503	Rannvro/lec'hienn pe an uheloc'h a zo diweredekaet e-pad un tamm.	Eiladenn gant adkavout eksponantel ha sklaer.

Kontrakt oberiant

YTSave a ro ur c'hwota oberiant gant pep aotreet evit diwall ar implijer API hag ar servijoù media uheloc'h.

Implij logik ar c'hinnig idempotent ha na kregit ket oberioù eilad evit ar klik-se gant an implijer heñvel.
Kuzhat a ra an titouroù metadonneoù evit un amzer berr, met e ranker bepred sellet ouzh ar URLoù download sinet evel ma'z int da echuiñ.
Implijout un adkavout eksponantel serret gant skuilh evit 429, 503 ha fazioù a c'hall bezañ adkavet.
Labourit nemet war mediaoù foran pe mediaoù ma vez roet an aotre deoc'h da zifenn anezho. N'eus ket a ziskaradennoù DRM pe kontroloù miret a vez treuzkaset.
Miret an IDioù goulenn ha an IDioù labour e logoù prevez obererezh. Na logit ket ar URLioù kaset hep ezhomm.

YTSave a merkañ an hent da zifenn ar c'henskrivadur dre anavezañ an aktivadenn a-raok mont e-barzh an enklask. Heñvel eo gant an autentifikadur roet ha dalc'h ar furmskridoù goulenniet e sell. Kemmañ OpenAPI

DIZHUNVADENN KEMER-DAREN

Goulenn ho alc'hwez API

Skrivañ an implijer API, e c'hendalc'h ar goulenn miziek ha talvoudegezhioù ar platfom skoazellet. YTSave a sellet da geñver ma vez resolvet, kaset ur raktres pe an daou a-gevret a-raok reiñ ur c'hleuzenn gwelet un dro.

Goulenn digoll API Ar c'hlewezhioù zo diabarzh ar c'huzul, gellout a reont bezañ nullañ ha roet dre ar furmskrid Kontakt. N'haller ket ober skriptoù anonim evit ober gant ar c'hargadenn.