Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med EasyF

EasyF viser grensesnittet på forhånd slik at utviklere kan estimere sitt arbeid. En støttegjennomgang er fortsatt nødvendig før en levende nøkkel og bruksgrense eksisterer.

EasyfClientJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

For å forklare API-vert, skiller EasyF støtteaktivert legitimasjon fra et tilordnet leietakerendpunkt. En arbeidsflyt med vanlig språk gir en server-bare-anropsbane sin egen plass.

Leietaker-URLhttps://easyf.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilEasyfClient

API-versjonv1

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

Legitimasjonssikkerhet starter med server-side hemmelig lagring på EasyF. Den neste visningen dekker ingen klient bunte innbygging. Siden holder ingen offentlige logger eller repositories synlig.

Løse en kobling

For å forklare Resolve-operasjonen skiller EasyF kildedeteksjon fra formater fra en sendt URL. En arbeidsflyt med vanlig språk gir ingen oppfunnet utganger sin egen plass.

POST/v1/resolveOmfang: løse

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

Formatidentifikatoren starter med den returnerte verdien uendret på EasyF. Den neste visningen dekker tilgjengelighet per kobling. Siden holder ingen gjettet kvalitetsmerke synlig.

Opprett og følg en nedlastingsjobb

EasyF presenterer tre praktiske punkter for Opprettelse av jobb. Først kommer asynkron forberedelse. Arbeidsflyten i klart språk dekker deretter en kort HTTP-forespørsel. Det siste punktet er begrenset utførelse av arbeidere.

POST/v1/jobsOmfang: jobber

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

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 AkseptertLagre@ action: button delivery_id.

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

EasyF nærmer seg jobbavstemning gjennom en innledende ventetid på ett sekund, og deretter en begrenset tilbakestilling.

Forutsigbare feil

EasyF organiserer Feil kontrakt rundt en ikke-2xx konvolutt. Dens vanlig språk arbeidsflyt sammenligner en støtte forespørsel ID. Forutsigbar klient håndtering forblir den siste sjekken.

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

EasyF avtaler praktiske bruksgrenser med hvert godkjent produkt for å bevare en forutsigbar guidet arbeidsflyt.

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.

For å forklare Schema-tilgang skiller EasyF aktivering før utforskning fra tilordnet autentisering. En arbeidsflyt med vanlig språk gir dokumenterte forespørselsformer sin egen plass.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Fortell EasyF hva du bygger, hvor ofte det vil kalle API-et og hvilke leverandører som betyr noe. Gjennomgangen avgjør tillatte operasjoner, og avslører deretter en legitimasjon én gang mens den kun lagrer dens sikre digest.

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