Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med EasyT

Denne EasyT-referansen er en implementeringsveiledning snarere enn et aktivt anonymt endepunkt. Produksjonstilgang begynner først etter at støtte godkjenner klienten og tildeler grenser.

EasytWorkspaceJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

API-vert starter med støtteaktivert legitimasjon på EasyT. Denne veiledede sjekken presenterer deretter et tildelt leietakerendepunkt. Det siste faktum er en serverkun kallsti.

Leietaker-URLhttps://easyt.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilEasytWorkspace

API-versjonv1

# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"

curl -X POST https://easyt.io/v1/resolve \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

I EasyT kommer server-side hemmelig lagring først når man forklarer sikkerhet for legitimasjon. Den veiledede sjekken følger med ingen klientpakke-innbygging og avsluttes med ingen offentlige logger eller arkiver.

Løse en kobling

Løsningsoperasjon begynner med kildeoppdagelse på EasyT. Denne veiledede sjekken presenterer deretter formater fra én innsendt URL. Det siste faktum er ingen oppdiktede utdata.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`input_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
}

I EasyT kommer den uendrede returnerte verdien først når Formatidentifikator forklares. Den veiledede sjekken følger med tilgjengelighet per lenke og avsluttes uten antatt kvalitetsmerke.

Opprett og følg en nedlastingsjobb

Asynkron forberedelse er utgangspunktet for jobbopprettelse på EasyT. En veiledet sjekk presenterer deretter en kort HTTP-forespørsel og forklarer bundet arbeidseksekvering.

POST/v1/jobsOmfang: jobber

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

curl -X POST https://easyt.io/v1/jobs \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'

1202 AkseptertLagre@ action: button workspace_job.

2AvstemningsstatusGET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

For jobbavstemming, EasyT begynner med ett sekunds initial ventetid. Dens veiledede sjekk kombinerer dette med begrenset tilbakekobling og avsluttes med midlertidig signert levering.

Forutsigbare feil

EasyT gjør Feilkontrakt enkel å skanne. Siden starter med ett ikke-2xx konvolutt, går videre til en støtteforespørsels-ID, og angir tydelig forutsigbar klientbehandling.

{
  "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

EasyT velger en driftsgodtgjørelse under gjennomgang, og balanserer applikasjonens behov med leverandørens helse.

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.

Skjematilgang begynner med aktivering før utforskning på EasyT. Denne veiledede sjekken presenterer deretter tildelt autentisering. Det endelige faktum er dokumenterte forespørselsformer.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Inkluder klientens formål, forventet månedlig arbeidsmengde og forespurte nettverk i aktiveringsnotatet. EasyT kan deretter velge å løse og definere jobbomfang korrekt før det produseres en oversiktlig hemmelighet.

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