Alleen voorbeeld — activering vereist

Bouw downloads met FFast

FFast toont de bedoelde API-vorm zonder publieke oproepen te activeren. Een operator activeert credentials en gemeten quota na het onderzoeken van de voorgestelde integratie.

FfastPipelineVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

FFast benadert de API-host via door ondersteuning geactiveerde referenties, gevolgd door een toegewezen tenant-eindpunt. De snelle beoordeling houdt een server-only oproep pad expliciet.

URL van tenanthttps://ffast.app

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantFfastPipeline

API-versiev1

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

Voor Credential veiligheid controleert FFast server-side geheime opslag voordat er geen client-bundel embedding plaatsvindt. Deze snelle controle zorgt er ook voor dat er geen openbare logs of repositories worden gewist.

Een koppeling oplossen

FFast benadert de Resolve-bewerking via brondetectie en formatteert vervolgens vanaf één ingediende URL. De snelle beoordeling houdt geen verzonnen uitvoer expliciet.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`fast_source`	HTTPS-URL	Ja.	Openbare of geautoriseerde mediapagina om te analyseren.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Voor Formaatidentificatie controleert FFast de geretourneerde waarde ongewijzigd vóór per-link beschikbaarheid. Deze snelle beoordeling maakt ook geen geraden kwaliteitslabel duidelijk.

Maak en volg een downloadtaak

FFast behandelt Jobcreatie door eerst asynchrone voorbereiding te identificeren. Het volgt met een korte HTTP-aanvraag en houdt de gebonden uitvoering van de worker in het oog.

POST/v1/jobsScope: vacatures

Veld	Type	Vereist	Beschrijving
`fast_source`	HTTPS-URL	Ja.	Dezelfde genormaliseerde bron ingediend om op te lossen.
`output_code`	tekenreeks	Ja.	Een exacte ID uit de resolve-respons.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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 GeaccepteerdOpslaan pipeline_run.

2Poll status 1GET /v1/jobs/{pipeline_run} met dezelfde sleutel.

3KlaarOpen de ondertekende download-URL.

Status	Betekenis	Actie van de klant
`queued`	Toegestaan in de beperkte wachtrij.	Poll weer met achteruit.
`extracting`	Bronmetadata of route vernieuwen.	Ga door met pollen.
`processing`	Bezig met downloaden, remuxen of samenvoegen.	Toon server voortgang.
`ready`	Ondertekende download is beschikbaar.	Stuur de URL naar de gebruiker.
`failed`	Terminal gestructureerde fout.	Lees `error_code`Probeer het alleen opnieuw als dat wordt geadviseerd.
`expired`	Tijdelijke uitvoer werd verwijderd.	Maak een nieuwe taak aan.

curl https://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

Het pollen van taken begint met een eerste wachttijd van één seconde op FFast. De volgende weergave behandelt beperkte back-off.

Voorspelbare fouten

De snelle beoordeling van FFast beoordeelt één niet-2xx envelop voor Error contract. Het toont een ondersteuningsverzoek-ID en verbergt geen voorspelbare clientafhandeling.

{
  "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	Typische betekenis	Actie
400	Ongeldige URL, body of niet beschikbare indeling.	Corrigeer de aanvraag. Los opnieuw op voor formaten.
401	Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.	Controleer de serverzijde referentie.
403	Tenant of bronbeleid heeft de aanvraag afgewezen.	Omzeil het beleid niet. Neem contact op met de ondersteuning.
404	Onbekende of verlopen vacature.	Maak indien nodig een nieuwe taak aan.
429	Aanvraag- of actieve-taaklimiet bereikt.	Eer `retry_after_seconds`.
503	Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.	Probeer het opnieuw met exponentiële backoff en jitter.

Operationeel contract

FFast activeert gemeten quota's die de overdracht responsief houden zonder onveilige belasting op upstream-platforms te plaatsen.

Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
Gebruik begrensde exponentiële backoff met jitter voor 429, 503 en herprobeerbare fouten.
Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.

FFast benadert Schema-toegang via activatie vóór verkenning, gevolgd door toegewezen authenticatie. De snelle beoordeling houdt gedocumenteerde aanvraagvormen expliciet.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Geef FFast een beknopte productomschrijving, verkeersprognose en platformlijst. Geef aan of metadatacontroles, voorbereide taken of beide nodig zijn zodat de uitgegeven sleutel overeenkomt met de daadwerkelijke workflow.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.