Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med FFast

FFast visar den avsedda API-strukturen utan att aktivera offentliga anrop. En operatör aktiverar autentiseringsuppgifter och mätta kvoter efter att ha granskat den föreslagna integrationen.

FfastPipelineJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

FFast närmar sig API-värden via stödaktiverade autentiseringsuppgifter, sedan en tilldelad hyresgästandpunkt. Den snabba granskningen håller en serverendast anropsväg tydlig.

Webbadress till klienthttps://ffast.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilFfastPipeline

API-versionv1

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

För säkerhetssäkerhet kontrollerar FFast serversidans hemliga lagring innan ingen klientbunt inbäddning. Denna snabba granskning gör också inga offentliga loggar eller lagringsplatser tydliga.

Lösa en länk

FFast närmar sig Resolve-operationen genom källidentifiering och formaterar sedan från en inskickad URL. Den snabba granskningen behåller inga påhittade utdata explicit.

POST/v1/resolveOmfattning: lösa

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

För formatidentifierare kontrollerar FFast det returnerade värdet oförändrat innan tillgänglighet per länk. Denna snabba granskning gör också att ingen gissad kvalitetsmärkning blir tydlig.

Skapa och följ ett nedladdningsjobb

FFast hanterar jobbskapande genom att först identifiera asynkron förberedelse. Det följs av en kort HTTP-förfrågan och håller begränsad arbetarexekvering i åtanke.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`fast_source`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`output_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://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 GodkändSpara pipeline_run.

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

Jobb-pollning startar med en initial väntan på en sekund på FFast. Nästa vy täcker begränsad backoff. Sidan håller temporär signerad leverans synlig.

Förutsägbara fel

FFast:s snabba granskning granskar ett icke-2xx-kuvert för Felkontrakt. Den visar ett supportförfrågnings-ID nästa och döljer inte förutsägbar klienthantering.

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

FFast aktiverar mätta kvoter som håller överlämningen responsiv utan att belasta upstream-plattformar osäkert.

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.

FFast närmar sig Schemaåtkomst genom aktivering före utforskning, följt av tilldelad autentisering. Den snabba granskningen håller dokumenterade förfrågningsformer tydliga.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Ge FFast en kort produktöversikt, trafikprognos och plattformslista. Ange om metadata-kontroller, förberedda jobb eller båda behövs så att den utfärdade nyckeln matchar det faktiska arbetsflödet.

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