Alleen voorbeeld — activering vereist

Bouwdownloads met EasyT

Deze EasyT-referentie is een implementatiehandleiding en geen actief anoniem eindpunt. Productietoegang begint pas nadat de ondersteuning de client heeft goedgekeurd en limieten heeft toegewezen.

EasytWorkspaceVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

API-host begint met ondersteuning-geactiveerde referenties op EasyT. Deze begeleide controle presenteert vervolgens een toegewezen tenant-eindpunt. Het laatste feit is een server-only aanroep pad.

URL van tenanthttps://easyt.io

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantEasytWorkspace

API-versiev1

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

In EasyT komt serverzijde geheime opslag eerst bij het uitleggen van Credential-veiligheid. Die begeleide controle volgt zonder client-bundel insluiting en sluit af zonder openbare logs of repositories.

Een koppeling oplossen

De resolutieoperatie begint met bronherkenning op EasyT. Deze begeleide controle presenteert vervolgens formaten van één ingediende URL. Het laatste feit is dat er geen verzonnen uitvoer is.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`input_url`	HTTPS-URL	Ja.	Openbare of geautoriseerde mediapagina om te analyseren.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

In EasyT komt de ongewijzigde geretourneerde waarde eerst bij het uitleggen van de Formaatidentificatie. Die begeleide controle volgt met beschikbaarheid per link en sluit af zonder geraden kwaliteitslabel.

Maak en volg een downloadtaak

Asynchrone voorbereiding is het startpunt voor Taakcreatie op EasyT. Een begeleide controle presenteert vervolgens een korte HTTP-aanvraag en legt gebonden uitvoering door de worker uit.

POST/v1/jobsScope: vacatures

Veld	Type	Vereist	Beschrijving
`input_url`	HTTPS-URL	Ja.	Dezelfde genormaliseerde bron ingediend om op te lossen.
`stream_choice`	tekenreeks	Ja.	Een exacte ID uit de resolve-respons.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

2Poll status 1GET /v1/jobs/{workspace_job} met dezelfde sleutel.

3KlaarOpen de ondertekende download-URL.

Status	Betekenis	Actie van de klant
`queued`	Toegestaan in de beperkte wachtrij.	Poll weer met achteruit.
`extracting`	Bronmetadata of route vernieuwen.	Ga door met pollen.
`processing`	Bezig met downloaden, remuxen of samenvoegen.	Toon server voortgang.
`ready`	Ondertekende download is beschikbaar.	Stuur de URL naar de gebruiker.
`failed`	Terminal gestructureerde fout.	Lees `error_code`Probeer het alleen opnieuw als dat wordt geadviseerd.
`expired`	Tijdelijke uitvoer werd verwijderd.	Maak een nieuwe taak aan.

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

Voor Job polling begint EasyT met een initiële wachttijd van één seconde. De begeleide controle combineert dit met een begrensde backoff en eindigt met tijdelijke ondertekende levering.

Voorspelbare fouten

EasyT maakt het gemakkelijk om het Foutcontract te scannen. De pagina begint met een niet-2xx envelop, gaat over naar een ondersteuningsverzoek-ID en vermeldt duidelijk voorspelbare clientafhandeling.

{
  "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	Typische betekenis	Actie
400	Ongeldige URL, body of niet beschikbare indeling.	Corrigeer de aanvraag. Los opnieuw op voor formaten.
401	Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.	Controleer de serverzijde referentie.
403	Tenant of bronbeleid heeft de aanvraag afgewezen.	Omzeil het beleid niet. Neem contact op met de ondersteuning.
404	Onbekende of verlopen vacature.	Maak indien nodig een nieuwe taak aan.
429	Aanvraag- of actieve-taaklimiet bereikt.	Eer `retry_after_seconds`.
503	Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.	Probeer het opnieuw met exponentiële backoff en jitter.

Operationeel contract

EasyT selecteert een operationele toelage tijdens de beoordeling, waarbij de behoeften van de applicatie worden afgewogen tegen de gezondheid van de aanbieder.

Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
Gebruik begrensde exponentiële backoff met jitter voor 429, 503 en herprobeerbare fouten.
Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.

Schema-toegang begint met activatie voordat er op EasyT wordt verkend. Deze begeleide controle presenteert vervolgens toegewezen authenticatie. Het laatste feit is gedocumenteerde aanvraagvormen.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Voeg het doel van de cliënt, de verwachte maandelijkse werklast en de gevraagde netwerken toe in de activatienota. EasyT kan dan de oplossings- en taakomvang correct kiezen voordat een one-view geheim wordt geproduceerd.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.