Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med EasyT

Denna EasyT-referens är en implementeringsguide snarare än en aktiv anonym slutpunkt. Produktionsåtkomst börjar först efter att support godkänt klienten och tilldelat gränser.

EasytWorkspaceJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

API-värd börjar med supportaktiverade autentiseringsuppgifter på EasyT. Denna guidade kontroll visar sedan en tilldelad hyresgästandpunkt. Den slutgiltiga faktan är en serverendast anropsväg.

Webbadress till klienthttps://easyt.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilEasytWorkspace

API-versionv1

# 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-sidig hemlagring först när Credential-säkerhet förklaras. Den guidade kontrollen följer med ingen klientpaket-inbäddning och avslutas med inga offentliga loggar eller arkiv.

Lösa en länk

Upplösningsoperationen börjar med källidentifiering på EasyT. Denna guidade kontroll visar sedan format från en inskickad URL. Det slutgiltiga faktumet är inga påhittade utdata.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`input_url`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

I EasyT kommer det oförändrade returvärdet först när Format identifier förklaras. Den guidade kontrollen följs av tillgänglighet per länk och avslutas med ingen gissad kvalitetsmärkning.

Skapa och följ ett nedladdningsjobb

Asynkron förberedelse är startpunkten för jobbskapande på EasyT. En guidad kontroll visar sedan en kort HTTP-förfrågan och förklarar begränsad arbetarexekvering.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`input_url`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`stream_choice`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara workspace_job.

2OmröstningsstatusGET /v1/jobs/{workspace_job} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

För Job polling börjar EasyT med en initial väntan på en sekund. Dess guidade kontroll kombinerar detta med begränsad backoff och avslutas med tillfällig signerad leverans.

Förutsägbara fel

EasyT gör felkontrakt enkelt att skanna. Sidan börjar med ett icke-2xx kuvert, går vidare till ett supportförfrågnings-ID och anger tydligt förutsägbar klienthantering.

{
  "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 betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

EasyT väljer en driftsbidrag under granskning, balansera programmets behov med leverantörens hälsa.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

Schemaåtkomst börjar med aktivering innan utforskning på EasyT. Denna guidade kontroll presenterar sedan tilldelad autentisering. Det slutgiltiga faktumet är dokumenterade förfrågningsformer.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Inkludera klientens syfte, förväntad månatlig arbetsbelastning och begärda nätverk i aktiveringsanteckningen. EasyT kan sedan välja att lösa och definiera arbetsomfång korrekt innan en översiktlig hemlighet produceras.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.