Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med FFast

FFast eksponerer den tiltenkte API-formen uten å slå på offentlige anrop. En operatør aktiverer legitimasjon og målte kvoter etter å ha undersøkt den foreslåtte integrasjonen.

FfastPipelineJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

FFast nærmer seg API-vert gjennom støtte-aktiverte legitimasjoner, deretter et tildelt leietaker-endepunkt. Den raske gjennomgangen holder en server-only kallbane eksplisitt.

Leietaker-URLhttps://ffast.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilFfastPipeline

API-versjonv1

# 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 sikkerhet, FFast sjekker server-side hemmelig lagring før ingen klient buntet embedding. Denne raske gjennomgang gjør også ingen offentlige logger eller repositories klart.

Løse en kobling

FFast nærmer seg Resolve-operasjonen gjennom kildeoppdagelse, deretter formaterer fra en innsendt URL. Den raske gjennomgangen holder ingen oppdiktede utdata eksplisitte.

POST/v1/resolveOmfang: løse

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

For formatidentifikator sjekker FFast den returnerte verdien uendret før tilgjengelighet per lenke. Denne raske gjennomgangen gjør heller ingen antatt kvalitetsmerkelapp tydelig.

Opprett og følg en nedlastingsjobb

FFast håndterer jobboppretting ved først å identifisere asynkron forberedelse. Den følger opp med en kort HTTP-forespørsel og holder begrenset arbeidseksekvering i sikte.

POST/v1/jobsOmfang: jobber

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

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

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

Jobb-polling starter med ett sekunds initial ventetid på FFast. Neste visning dekker begrenset tilbakefall. Siden holder midlertidig signert levering synlig.

Forutsigbare feil

FFast s raske gjennomgang vurderer ett ikke-2xx-konvolutt for Feil-kontrakt. Den viser en støtteforespørsels-ID etterpå og skjuler ikke forutsigbar klientbehandling.

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

FFast aktiverer målte kvoter som holder overføringen responsiv uten å legge usikker belastning på oppstrøms plattformer.

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.

FFast nærmer seg skjema-tilgang gjennom aktivering før utforskning, deretter tildelt autentisering. Den raske gjennomgangen holder dokumenterte forespørselsformer eksplisitte.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Gi FFast en kortfattet produktoversikt, trafikkprognose og plattformliste. Oppgi om metadata-sjekker, forberedte jobber eller begge deler er nødvendig slik at den utstedte nøkkelen samsvarer med den faktiske arbeidsflyten.

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