Solo anteprima — attivazione richiesta

Costruire i download con FFast

FFast espone la forma API prevista senza attivare chiamate pubbliche. Un operatore attiva le credenziali e le quote misurate dopo aver esaminato l'integrazione proposta.

FfastPipelineJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

FFast accede all'host API tramite credenziali attivate dal supporto, quindi a un endpoint tenant assegnato. La revisione rapida mantiene esplicito un percorso di chiamata solo server.

URL del tenanthttps://ffast.app

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteFfastPipeline

Versione dell'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"}'

Per la sicurezza delle Credenziali, FFast verifica l'archiviazione segreta lato server prima di non incorporare alcun bundle client. Questa revisione rapida evita anche log o repository pubblici.

Risolvere un collegamento

FFast si avvicina all'operazione Resolve attraverso il rilevamento della fonte, quindi formatta da un URL inviato.

POST/v1/resolveAmbito di applicazione: risolvere

Campo	Tipo	Obbligatorio	Descrizione
`fast_source`	URL HTTPS	Sì	Pagina media pubblica o autorizzata da analizzare.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

Per l'identificatore di formato, FFast controlla il valore restituito invariato prima della disponibilità per collegamento. Questa revisione rapida non rende chiara alcuna etichetta di qualità indovinata.

Creare e seguire un processo di download

FFast gestisce la creazione del Job identificando prima la preparazione asincrona, quindi segue con una breve richiesta HTTP e mantiene in vista l'esecuzione del worker limitato.

POST/v1/jobsAmbito: posti di lavoro

Campo	Tipo	Obbligatorio	Descrizione
`fast_source`	URL HTTPS	Sì	La stessa fonte normalizzata è stata inviata per la risoluzione.
`output_code`	stringa	Sì	Un ID esatto dalla risposta di risoluzione.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

2Stato del sondaggioGET /v1/jobs/{pipeline_run} con la stessa chiave.

3ProntoAprire l'URL di download firmato.

Stato	Significato	Azione del cliente
`queued`	Ammesso alla coda limitata.	Sondaggio di nuovo con backoff.
`extracting`	Aggiornamento dei metadati di origine o della rotta.	Continua a sondare.
`processing`	Scaricare, remux o unire.	Visualizza il progresso del server.
`ready`	Il download firmato è disponibile.	Invia l'URL all'utente.
`failed`	Errore strutturato terminale.	Leggi `error_code`Riprova solo quando ti viene consigliato.
`expired`	L'uscita temporanea è stata rimossa.	Creare un nuovo lavoro.

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

Il polling del lavoro inizia con un'attesa iniziale di un secondo su FFast. La vista successiva copre il backoff limitato.

Errori prevedibili

FFast La recensione rapida esamina una singola busta non 2xx per il contratto di errore. Mostra un ID richiesta di supporto successivo e non oscura la gestione prevedibile del client.

{
  "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	Significato tipico	Azione
400	URL, corpo o formato non valido.	Correggi la richiesta. Risolvi di nuovo per i formati.
401	Chiave mancante, non valida, scaduta o con ambito errato.	Verificare le credenziali lato server.
403	Criterio di tenant o di origine ha rifiutato la richiesta.	Non aggirare la politica. Contattare l'assistenza.
404	Offerta di lavoro sconosciuta o scaduta.	Creare un nuovo lavoro, se del caso.
429	Richiesta o limite di lavori attivi raggiunto.	Onore `retry_after_seconds`.
503	Coda/capacità o upstream temporaneamente non disponibile.	Riprova con backoff esponenziale e jitter.

Contratto operativo

FFast attiva le quote misurate che mantengono l'trasferimento reattivo senza posizionare carichi non sicuri sulle piattaforme a monte.

Usa una logica applicativa idempotente e non avviare mai lavori duplicati per lo stesso clic dell'utente.
Memorizza brevemente i metadati di risoluzione, ma considera sempre le URL di download firmate come scadute.
Usa il backoff esponenziale limitato con jitter per 429, 503 e errori riprovabili.
Elabora solo media pubblici o media a cui sei autorizzato ad accedere. DRM e controlli di accesso non vengono bypassati.
Conserva gli ID delle richieste e gli ID dei lavori nei registri operativi privati. Non registrare inutilmente gli URL inviati.

FFast accede allo Schema tramite attivazione prima dell'esplorazione, quindi autenticazione assegnata. La revisione rapida mantiene esplicite le forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Fornisci a FFast un riassunto conciso del prodotto, una proiezione del traffico e un elenco delle piattaforme. Indica se sono necessari controlli dei metadati, lavori preparati o entrambi affinché la chiave emessa corrisponda al flusso di lavoro effettivo.

Richiedi attivazione Le chiavi sono limitate all'inquilino, revocabili e rilasciate tramite il modulo di contatto. Gli script anonimi non possono eseguire lavori di download.