Kun prøveversion — aktivering kræves

Byg downloads med EasyT

Denne EasyT-reference er en implementeringsvejledning snarere end et aktivt anonymt endepunkt. Produktionsadgang begynder først, efter support godkender klienten og tildeler grænser.

EasytWorkspaceJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

API-værten starter med support-aktiverede legitimationsoplysninger på EasyT. Denne guidede kontrol præsenterer derefter en tildelt lejer-endpoint. Det endelige faktum er en server-only kaldesti.

Lejer- URLhttps://easyt.io

GodkendelseX-API-Key: pending_activation_…

Profil af klientEasytWorkspace

Version af APIv1

# 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 Credential-sikkerhed forklares. Den guidede kontrol følger uden klientpakkeindlejring og afsluttes uden offentlige logfiler eller arkiver.

Løsning af et link

Opløsningsoperationen begynder med kildeidentifikation på EasyT. Denne guidede kontrol præsenterer derefter formater fra en indsendt URL. Det endelige faktum er, at der ikke er opfundet output.

POST/v1/resolveOmfang: løse

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

I EasyT kommer den uændrede returnerede værdi først, når Formatidentifikator forklares. Den vejledte kontrol følger med tilgængelighed pr. link og afsluttes uden gættet kvalitetsmærke.

Opret og følg et downloadjob

Asynkron forberedelse er udgangspunktet for Joboprettelse på EasyT. En guidet kontrol præsenterer derefter en kort HTTP-anmodning og forklarer begrænset arbejderskørsel.

POST/v1/jobsOmfang: job

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

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

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

For jobafstemning starter EasyT med en indledende ventetid på et sekund. Dens vejledte kontrol kombinerer dette med begrænset tilbagefald og afsluttes med midlertidig signeret levering.

Forudsigelige fejl

EasyT gør Fejlkontakt nem at scanne. Siden starter med en ikke-2xx konvolut, går videre til en supportanmodnings-ID og angiver klart forudsigelig klienthåndtering.

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

EasyT vælger en driftsbevilling under gennemgang, der balancerer applikationens behov med udbyderens sundhed.

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.

Skemaadgang begynder med aktivering før udforskning på EasyT. Denne guidede kontrol præsenterer derefter tildelt autentificering. Det endelige faktum er dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Inkluder klientformålet, forventet månedligt arbejdsbyrde og anmodede netværk i aktiveringsnotatet. EasyT kan derefter vælge at løse og jobomfang korrekt, før der produceres en one-view hemmelighed.

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