Produktion REST API · v1

Byg downloads med YTSave

Løs en offentlig medie-URL, vælg et præcist format, opret et asynkront job og overlever det signerede resultat til din bruger. Den samme bundne produktionspipeline driver YTSave-webstedet.

YTSaveClientJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

YTSave håndterer API-vært ved først at identificere support-aktiverede legitimationsoplysninger. Den følger med en tildelt lejer-endpoint og holder en server-only opkaldssti i visning.

Lejer- URLhttps://ytsave.app

GodkendelseX-API-Key: ys_live_…

Profil af klientYTSaveClient

Version af 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"}'

For at forklare legitimationssikkerhed adskiller YTSave serverside hemmelig opbevaring fra ingen klientpakkeindlejring. En bevisoptagelse giver ingen offentlige logfiler eller arkiver sin egen plads.

Løsning af et link

YTSave håndterer Resolve-operationen ved først at identificere kildeopdagelse. Den følger op med formater fra en indsendt URL og holder ingen opfundne output i sigte.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`url`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

For at forklare formatidentifikator adskiller YTSave den returnerede værdi uændret fra tilgængelighed pr. link. En bevisoptagelse giver ingen gættet kvalitetsmærkat sin egen plads.

Opret og følg et downloadjob

For Joboprettelse begynder YTSave med asynkron forberedelse. Dens bevisregistrering parrer det med en kort HTTP-anmodning og slutter med begrænset arbejderekskvering.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`url`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`format_id`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

2AfstemningsstatusGET /v1/jobs/{job_id} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

YTSave gør jobafstemning nem at scanne. Siden starter med et initialt vent på et sekund, går videre til begrænset tilbagefald og angiver tydeligt midlertidig underskrevet levering.

Forudsigelige fejl

For fejlkontrakt kontrollerer YTSave én ikke-2xx kuvert før en supportanmodnings-ID. Denne bevisoptagelse gør også forudsigelig klienthåndtering klar.

{
  "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 utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

YTSave udsteder en operationel kvote ved hver godkendelse for at beskytte API-forbrugeren og upstream medietjenester.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

YTSave håndterer Schema-adgang ved først at identificere aktivering før udforskning. Det følger op med tildelt autentificering og holder dokumenterede anmodningsformer i fokus. OpenAPI-reference

OPERATØRGENNEMGÅET ADGANG

Anmod om din API-nøgle

Dokumenter API-forbrugeren, dets månedlige anmodningsestimat og understøttede platformskrav.YTSave gennemgår, om løsning, jobindsendelse eller begge dele er berettiget, før der udstedes en engangsnøgle.

Anmod om API-adgang Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.