EKOIZPEN REST API · v1

Eraiki deskargak YTSave-rekin

Ebatzi media URL publiko bat, hautatu formatua zehatza, sortu lan asinkrono bat eta eman sinatutako emaitza zure erabiltzaileari. Produkzio-pipeline mugatu bera da YTSave webgunea elikatzen duena.

YTSaveClientJSON HTTPS bidezAsinkronoak diren lanakEskumen mugatuak

Azkar hasiera

YTSave API ostalaria kudeatzen du lehenik laguntza-aktibatutako kredentzialak identifikatuz. Ondoren, alokatutako alokairu puntua jarraitzen du eta zerbitzari bakarreko dei bidea ikusgai mantentzen du.

Alokairu URLhttps://ytsave.app

AutentifikazioaX-API-Key: ys_live_…

Bezeroaren profilaYTSaveClient

API bertsioav1

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

Credential segurtasuna azaltzeko, YTSave zerbitzari aldeko sekretu biltegiratzea bezero paketerik gabe bereizten du. Ebidentzia erregistro batek ez du inolako log publiko edo biltegiren lekua ematen.

Esteka bat konpondu

YTSave Ebazteko operazioa kudeatzen du iturburuaren detekzioa lehen identifikatuz. Ondoren, bidalitako URL bateko formatuak jarraitzen ditu eta ez du asmatutako irteerarik ikuspegian gordetzen.

POST/v1/resolveEsparrua: ebaztu

Eremua	Mota	Beharrezkoa	Deskribapena
`url`	HTTPS URLa	Bai	Aztertu beharreko hedabide publiko edo baimendutako orria
`tenant`	katea	Ez	Esleitutako alokairu domeinua. Normalean ez da sartzen.

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

Formatu identifikatzailea azaltzeko, YTSave itzuli den balioa bere horretan bereizten du esteka bakoitzeko erabilgarritasunetik. Ebidentzia erregistro batek ez du kalitate etiketarik asmatuaren tokirik ematen.

Sortu eta jarraitu deskarga-lana

Lan sortzerako, YTSave asinkronoa prestaketa batekin hasten da. Bere eztabaida erregistroak HTTP eskaera labur batekin lotzen du eta langilearen exekuzio mugatuarekin amaitzen da.

POST/v1/jobsEsparrua: lanak

Eremua	Mota	Beharrezkoa	Deskribapena
`url`	HTTPS URLa	Bai	Iturburu normalizatu bera bidali da konpontzeko.
`format_id`	katea	Bai	Erantzunaren ID zehatza.
`tenant`	katea	Ez	Esleitutako alokairu domeinua. Normalean ez da sartzen.

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

2Inkesta egoeraGET /v1/jobs/{job_id} giltza berarekin.

3PrestIreki sinatutako deskarga URLa.

Egoera	Baliokidea	Bezeroaren ekintza
`queued`	Mugatutako ilaran onartua.	Botoa berriro egin atzerapenarekin.
`extracting`	Iturburuaren metadatuak edo bidea freskatzen.	Inkesta jarraitu.
`processing`	Deskargatzen, berrantolatzen edo bateratzen.	Erakutsi zerbitzariaren aurrerapena.
`ready`	Sinatutako deskarga erabilgarri dago.	Bidali URLa erabiltzaileari.
`failed`	Terminaleko egituratutako errorea.	Irakurri `error_code`. Saiatu berriro aholkatzen denean bakarrik.
`expired`	Emaitza aldiuneko ezabatu da.	Lan berri bat sortu.

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

YTSave-k Job inkestatzea errazten du eskaneatzeko. Orria segunduko itxarote batekin hasten da, atzerapen mugatu batera pasatzen da, eta entrega aldi baterako sinatua argi adierazten du.

Aurresan daitezkeen akatsak

Errore kontratuarentzat, YTSave-k 2xx ez den gutunazal bat egiaztatzen du laguntza eskaera ID baten aurretik. Ebidentzia erregistro honek bezeroaren tratamendu aurreikusgarria ere argitzen du.

{
  "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	Ohiko esanahia	Ekintza
400	URL baliogabea, edukia edo formatu ez erabilgarria.	Zuzen ezazu eskaera. Formatuetarako berriro ebaztu.
401	Giltza falta da, baliogabea da, iraungita dago edo esparru okerrekoa da.	Egiaztatu zerbitzari aldeko kredentziala.
403	Alokairu edo iturri politikak eskaera baztertu du.	Ez saihestu politika. Jarri harremanetan laguntza zerbitzuarekin.
404	Lan ezezaguna edo iraungitakoa.	Sortu lan berri bat egokia bada.
429	Eskaera edo lan aktiboen muga gainditu da.	Ohore `retry_after_seconds`.
503	Ilara/ahalmena edo goiko fluxua une batez ez dago erabilgarri.	Saiatu berriro atzerapen esponentzialarekin eta jitterrarekin.

Funtzionamendu-kontratua

YTSave operazio kuota bat ematen du onarpen bakoitzean API kontsumitzailea eta goiko hedabide zerbitzuak babesteko.

Erabili aplikazio logika idempotentea eta ez hasi inoiz lan bikoiztuak erabiltzaile klik bererako.
Cacheak ebazten du metadatuak labur, baina beti tratatu sinatutako deskarga URLak iraungitzen diren moduan.
Erabili jitterrekin mugatutako atzerapen esponentziala 429, 503 eta berriro saiatu daitezkeen akatsak.
Prozesatu soilik publikoak diren edukiak edo sarbidea baimenduta duzun edukiak. DRM eta sarbide kontrolak ez dira saihesten.
Gorde eskaera IDak eta lan IDak pribatuko eragiketa logetan. Ez sartu beharrezkoak ez diren bidalitako URLak logetan.

YTSave Esquema sarbidea kudeatzen du lehenik aktibazioa identifikatuz esploratu aurretik. Ondoren, autentifikazio esleitua jarraitzen du eta eskaera formak dokumentatuak ikuspegi batean mantentzen ditu. OpenAPI erreferentzia

ERABILTZAILEAK BERRIKUSITAKO SARBIDEA

Eskatu zure API gakoa

Dokumentatu API kontsumitzailea, bere hilabeteko eskaera estimazioa eta laguntza ematen duten plataformen eskakizunak. YTSave berrikusten du ebazpena, lanaren aurkezpena edo biak justifikatuak diren ala ez, behin ikusgai izan den gako bat emateko aurretik.

API sarbidea eskatu Giltzak alokairu-esparruak dira, baliogabetu daitezkeenak eta Kontaktua formularioaren bidez ematen direnak. Anonimoko script-ek ezin dute deskargatzaile-lanak exekutatu.