Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med EasyF

EasyF visar gränssnittet i förväg så att utvecklare kan uppskatta sitt arbete. En supportgranskning krävs fortfarande innan en live-nyckel och användningsgräns finns.

EasyfClientJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

För att förklara API-värd separerar EasyF supportaktiverade autentiseringsuppgifter från en tilldelad hyresgästandpunkt. Ett arbetsflöde i klartext ger en server-endast anropsväg sin egen plats.

Webbadress till klienthttps://easyf.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilEasyfClient

API-versionv1

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

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

Säkerhet för autentiseringsuppgifter börjar med server-sidig hemlig lagring på EasyF. Nästa vy täcker ingen inbäddning av klientpaket. Sidan behåller inga offentliga loggar eller synliga arkiv.

Lösa en länk

För att förklara Resolve-operationen separerar EasyF källdetektering från format från en inskickad URL. Ett lättförståeligt arbetsflöde ger inga påhittade utdata en egen plats.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`asset_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
}

Formatidentifieraren börjar med det returnerade värdet oförändrat på EasyF. Nästa vy täcker tillgänglighet per länk. Sidan visar ingen gissad kvalitetsmärkning.

Skapa och följ ett nedladdningsjobb

EasyF presenterar tre praktiska punkter för Jobbskapande. Först kommer asynkron förberedelse. Arbetsflödet i klartext täcker sedan en kort HTTP-förfrågan. Dess sista punkt är begränsad arbetarexekvering.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`asset_url`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`variant_code`	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://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 GodkändSpara delivery_id.

2OmröstningsstatusGET /v1/jobs/{delivery_id} 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://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF närmar sig jobb-polling genom en initial väntan på en sekund, följt av begränsad backoff. Arbetsflödet i klartext håller temporär signerad leverans tydlig.

Förutsägbara fel

EasyF organiserar Felkontrakt kring ett icke-2xx kuvert. Dess arbetsflöde i klartext jämför en supportförfrågnings-ID. Förutsägbar klienthantering förblir den slutgiltiga kontrollen.

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

EasyF överensstämmer med praktiska användningsgränser med varje godkänd produkt för att bevara ett förutsägbart guidad arbetsflöde.

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.

För att förklara Schema-åtkomst separerar EasyF aktivering före utforskning från tilldelad autentisering. Ett arbetsflöde i klartext ger dokumenterade förfrågningsformer en egen plats.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Berätta för EasyF vad du bygger, hur ofta det kommer att anropa API:et och vilka leverantörer som är viktiga. Granskningen bestämmer de tillåtna operationerna och avslöjar sedan en referens en gång samtidigt som endast dess säkra digest sparas.

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