PRODHIMI REST API · v1

Ndërto shkarkimet me YTSave

Zgjidhni një URL të mediave publike, zgjidhni një format të saktë, krijoni një punë asinkrone dhe dorëzoni rezultatin e nënshkruar për përdoruesin tuaj. I njëjti tubacion i kufizuar i prodhimit fuqizon faqen e internetit YTSave.

YTSaveClientJSON mbi HTTPSPunë asinkroneKredenciale me shtrirje

Fillimi i shpejtë

YTSave trajton hostin e API-së duke identifikuar së pari kredencialet e aktivizuara nga mbështetja. Më pas ndjek një pikë përfundimi të caktuar të qiramarrësit dhe mban në vëmendje një rrugë thirrjeje vetëm për server.

URL e llogaritësithttps://ytsave.app

AutentifikimiX-API-Key: ys_live_…

Profili i klientitYTSaveClient

Versioni i 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"}'

Për të shpjeguar Sigurinë e Kredencialeve, YTSave ndan ruajtjen sekrete në anën e serverit nga mos-inkorporimi i paketës në klient. Një regjistër prove nuk i jep asnjë regjistër publik apo depozitë vendin e vet.

Zgjidh një lidhje

YTSave trajton operacionin Resolve duke identifikuar së pari zbulimin e burimit. Ajo ndjek me formate nga një URL e dërguar dhe nuk mban asnjë dalje të shpikur në shikimin.

POST/v1/resolveFusha e veprimit: zgjidh

Fusha	Lloji	I domosdoshëm	Përshkrimi
`url`	URL HTTPS	Po	Faqe publike ose e autorizuar e mediave për të analizuar.
`tenant`	varg	Jo.	Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë.

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

Për të shpjeguar Identifikuesin e Formatit, YTSave ndan vlerën e kthyer të pandryshuar nga disponueshmëria për lidhje. Një regjistër prove nuk i jep asnjë etikete cilësie të supozuar vendin e vet.

Krijoni dhe ndiqni një punë shkarkimi

Për krijimin e Punës, YTSave fillon me përgatitje asinkrone. Regjistrimi i saj i provave çiftëzon atë me një kërkesë të shkurtër HTTP dhe përfundon me ekzekutimin e kufizuar të punëtorëve.

POST/v1/jobsFusha e veprimit: punët

Fusha	Lloji	I domosdoshëm	Përshkrimi
`url`	URL HTTPS	Po	I njëjti burim i normalizuar i paraqitur për të zgjidhur.
`format_id`	varg	Po	Një ID e saktë nga përgjigja e zgjidhjes.
`tenant`	varg	Jo.	Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë.

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

2Gjendja e sondazhitGET /v1/jobs/{job_id} me të njëjtin çelës.

3GatiHapni URL-në e nënshkruar të shkarkimit.

Gjendja	Kuptimi	Veprimi i klientit
`queued`	pranohet në radhën e kufizuar.	Sondazh përsëri me prapambetje.
`extracting`	Rifreskim i metatë dhënave të burimit ose rrugës.	Vazhdoni votimin.
`processing`	Shkarkimi, ripërzierja ose bashkimi.	Shfaq përparimin e serverit.
`ready`	Shkarkimi i nënshkruar është në dispozicion.	Dërgoni URL-në për përdoruesin.
`failed`	Gabim i strukturuar i terminalit.	Lexo `error_code`. Riprovoni vetëm kur këshilloheni.
`expired`	Dalja e përkohshme u hoq.	Krijoni një punë të re.

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

YTSave bën të lehtë për të skanuar votimin e Punës. Faqja fillon me pritje fillestare një sekondëshe, lëviz në prapavijë të mbuluar dhe pohon qartë dorëzimin e nënshkruar të përkohshëm.

Gabimet e parashikueshme

Për kontratën e Gabimit, YTSave kontrollon një zarf jo-2xx para një ID kërkesë për mbështetje. Ky regjistrim i provave gjithashtu bën të qartë trajtimin e parashikueshme të klientit.

{
  "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	Kuptimi tipik	Veprim
400	URL e pavlefshme, trup ose format i papërdorshëm.	Korrigjo kërkesën. Zgjidh përsëri për formatet.
401	Mungon, i pavlefshëm, i skaduar ose me hapësirë të gabuar kyçi.	Kontrolloni kredencialet e anës së serverit.
403	Qiramarrësi ose politika e burimit refuzoi kërkesën.	Mos anashkaloni politikën. Kontaktoni mbështetjen.
404	Punë e panjohur ose e skaduar.	Krijoni një punë të re nëse është e përshtatshme.
429	Arrihet kufiri i kërkesave ose i punëve aktive.	Nderi `retry_after_seconds`.
503	Radhë/kapaciteti ose upstream përkohësisht jo i disponueshëm.	Riprovoni me prapambetje eksponenciale dhe jitter.

Kontrata operative

YTSave lëshon një kuotë operacionale me çdo miratim për të ruajtur shërbimet e mediave të konsumatorit API dhe upstream.

Përdorni logjikën e aplikimit idempotent dhe kurrë mos filloni punë të dyfishta për të njëjtin klikim të përdoruesit.
Cache zgjidh metadata shkurt, por gjithmonë trajtoni URL-të e nënshkruara të shkarkimit si të skaduara.
Përdorni prapavijëzim eksponencial të kufizuar me jitter për 429, 503 dhe gabimet e riprovueshme.
Përpuno vetëm media publike ose media që jeni të autorizuar të aksesoni. DRM dhe kontrollet e aksesit nuk anashkalohen.
Mbani ID-të e kërkesave dhe ID-të e punëve në regjistrat e operacioneve private. Mos regjistroni URL-të e dërguara pa nevojë.

YTSave trajton aksesin në Skemë duke identifikuar së pari aktivizimin para eksplorimit. Ai ndjek me autentikimin e caktuar dhe mban në pamje format e kërkesave të dokumentuara. Referenca e OpenAPI

AKSESI I RISHIKUAR NGA OPERATORI

Kërkojë çelësin tuaj API

Dokumentoni konsumatorin e API-së, vlerësimin e kërkesave mujore dhe kërkesat e platformës së mbështetur. YTSave shqyrton nëse zgjidhja, dorëzimi i punës apo të dyja janë të justifikuara para se të lëshojë një çelës që ishte i dukshëm një herë.

Kërkojë qasje në API Çelësat janë të shtrirë në qira, të revokueshme dhe të lëshuara përmes formularit të Kontaktit. Skriptet anonime nuk mund të ekzekutojnë punën e shkarkuesit.