Kun prøveversion — aktivering kræves

Byg downloads med EasyF

EasyF viser grænsefladen på forhånd, så udviklere kan estimere deres arbejde. En supportgennemgang er stadig påkrævet, før en live-nøgle og brugsgrænse eksisterer.

EasyfClientJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

For at forklare API-vært adskiller EasyF support-aktiverede legitimationsoplysninger fra en tildelt lejer-endpoint. En almindelig sprogworkflow giver en server-only opkaldssti sin egen plads.

Lejer- URLhttps://easyf.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientEasyfClient

Version af APIv1

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

Sikkerhed for legitimationsoplysninger starter med server-side hemmelig opbevaring på EasyF. Det næste udsyn dækker ingen klientpakkeindlejring. Siden gemmer ingen offentlige logfiler eller synlige arkiver.

Løsning af et link

For at forklare Resolve-operationen adskiller EasyF kildedetektion fra formater fra en indsendt URL. Et workflow i almindeligt sprog giver ingen opfundne output deres eget sted.

POST/v1/resolveOmfang: løse

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

Formatidentifikatoren starter med den returnerede værdi uændret på EasyF. Den næste visning dækker tilgængelighed pr. link. Siden viser ikke nogen gættet kvalitetsmærkat.

Opret og følg et downloadjob

EasyF præsenterer tre praktiske punkter for joboprettelse. Først kommer asynkron forberedelse. Arbejdsgangen i almindeligt sprog dækker derefter en kort HTTP-anmodning. Det sidste punkt er begrænset udførelse af arbejderen.

POST/v1/jobsOmfang: job

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

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

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

EasyF håndterer Job-afstemning gennem et indledende vent på et sekund, efterfulgt af begrænset tilbagefald. Arbejdsgangen i almindeligt sprog holder midlertidig underskrevet levering eksplicit.

Forudsigelige fejl

EasyF organiserer Fejlaftale omkring en enkelt ikke-2xx kuvert. Dens workflow i almindeligt sprog sammenligner en supportanmodnings-ID. Forudsigelig klienthåndtering forbliver den endelige kontrol.

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

EasyF aftaler praktiske brugsgrænser med hvert godkendt produkt for at bevare en forudsigelig guidet arbejdsgang.

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.

For at forklare Schema-adgang adskiller EasyF aktivering før udforskning fra tildelt autentificering. En almindelig sprogworkflow giver dokumenterede anmodningsformer sin egen plads.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Fortæl EasyF, hvad du bygger, hvor ofte det vil kalde API'en, og hvilke udbydere der betyder noget. Gennemgangen beslutter de tilladte operationer og afslører derefter en legitimationsoplysning én gang, mens kun dens sikre digest gemmes.

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