PRODUKSJON REST API · v1

Bygg nedlastinger med YTSave

Løs opp en offentlig medie-URL, velg et eksakt format, opprett en asynkron jobb og lever det signerte resultatet til brukeren din. Den samme bundne produksjonspipelinen driver YTSave-nettstedet.

YTSaveClientJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

YTSave håndterer API-vert ved først å identifisere støtte-aktiverte legitimasjoner. Den følger med en tildelt leietaker-endepunkt og holder en server-only kallsti i visning.

Leietaker-URLhttps://ytsave.app

AutentiseringX-API-Key: ys_live_…

KlientprofilYTSaveClient

API-versjonv1

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

For å forklare legitimasjonssikkerhet skiller YTSave server-side hemmelig lagring fra ingen klientpakke-innbygging. Et bevismateriale gir ingen offentlige logger eller arkiver sin egen plass.

Løse en kobling

YTSave håndterer Resolve-operasjonen ved først å identifisere kildeoppdagelse. Den følger med formater fra en innsendt URL og holder ingen oppdiktede utdata i sikte.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`url`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

For å forklare formatidentifikator skiller YTSave den returnerte verdien uendret fra tilgjengelighet per lenke. Et bevismateriale gir ingen gjettet kvalitetsmerkelapp sin egen plass.

Opprett og følg en nedlastingsjobb

For Jobbopprettelse begynner YTSave med asynkron forberedelse. Dens bevisregistrering kombinerer dette med en kort HTTP-forespørsel og avsluttes med begrenset arbeidsutførelse.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`url`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`format_id`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button job_id.

2AvstemningsstatusGET /v1/jobs/{job_id} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

YTSave gjør Job polling enkelt å skanne. Siden starter med ett sekunds initial ventetid, går over til begrenset tilbakefall, og angir tydelig midlertidig signert levering.

Forutsigbare feil

For feilkonto, sjekker YTSave ett ikke-2xx-konvolutt før en støtteforespørsels-ID. Dette bevisregisteret gjør også forutsigbar klienthåndtering tydelig.

{
  "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	Typisk betydning	Handling
400	Ugyldig URL, brødtekst eller utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

YTSave utsteder en operasjonell kvote med hver godkjenning for å beskytte API-forbrukeren og oppstrøms medietjenester.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

YTSave håndterer Schema-tilgang ved først å identifisere aktivering før utforskning. Den følger opp med tildelt autentisering og holder dokumenterte forespørselsformer synlige. OpenAPI- referanse

TILGANG SOM OVERVÅKES AV OPERATOR

Be om din API-nøkkel

Dokumenter API-forbrukeren, dens månedlige forespørselsestimat og støttede plattformkrav. YTSave vurderer om oppløsning, jobbinnlevering eller begge deler er berettiget før utstedelse av en engangssynlig nøkkel.

Be om API-tilgang Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.