Kun prøveversion — aktivering kræves

Byg downloads med FFast

FFast eksponerer den tilsigtede API-form uden at aktivere offentlige opkald. En operatør aktiverer legitimationsoplysninger og målte kvoter efter undersøgelse af den foreslåede integration.

FfastPipelineJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

FFast tilgår API-værten gennem support-aktiverede legitimationsoplysninger og derefter en tildelt lejer-endpoint. Den hurtige gennemgang holder en server-only kaldsti eksplicit.

Lejer- URLhttps://ffast.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientFfastPipeline

Version af APIv1

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

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

For Credential sikkerhed, FFast kontrollerer server-side hemmelige opbevaring før ingen klient bundle embedding. Denne hurtige gennemgang gør også ingen offentlige logfiler eller repositories klar.

Løsning af et link

FFast nærmer sig Resolve-operationen gennem kildedetektion og formaterer derefter fra en indsendt URL. Den hurtige gennemgang holder ingen opfundne output eksplicitte.

POST/v1/resolveOmfang: løse

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

For Format-identifikator kontrollerer FFast den returnerede værdi uændret, før den er tilgængelig pr. link. Denne hurtige gennemgang gør det også klart, at der ikke er nogen gættet kvalitetsmærke.

Opret og følg et downloadjob

FFast håndterer oprettelse af job ved først at identificere asynkron forberedelse, følger op med en kort HTTP-anmodning og holder øje med begrænset arbejdsudførelse.

POST/v1/jobsOmfang: job

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

curl -X POST https://ffast.app/v1/jobs \
  -H "X-API-Key: $FFAST_PIPELINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'

1202 AccepteretGem pipeline_run.

2AfstemningsstatusGET /v1/jobs/{pipeline_run} 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://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

Jobafstemning starter med et indledende vent på et sekund på FFast. Det næste overblik dækker begrænset tilbagefald. Siden holder midlertidig signeret levering synlig.

Forudsigelige fejl

FFast: hurtige gennemgang gennemgår en ikke-2xx-konvolut for Fejlkontrakt. Det viser et supportanmodnings-id næste og skjuler ikke forudsigelig klienthåndtering.

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

FFast aktiverer målte kvoter, der holder overførslen responsiv uden at belaste upstream-platforme usikkert.

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.

FFast tilgår skemaadgang gennem aktivering før udforskning, derefter tildelt autentificering. Den hurtige gennemgang holder dokumenterede anmodningsformer eksplicit.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Giv FFast en kortfattet produktoversigt, trafikprognose og platformsliste Angiv, om der er behov for metadatakontrol, forberedte job eller begge dele, så den udstedte nøgle svarer til den faktiske arbejdsgang.

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