Numai previzualizare — activare necesară

Construiți descărcări cu FFast

FFast expune forma API-ului dorit fără a activa apelurile publice. Un operator activează acreditările și cotele măsurate după ce examinează integrarea propusă.

FfastPipelineJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

FFast se apropie de gazda API prin credențiale activate de asistență, apoi printr-un endpoint atribuit al tenantului. Revizuirea rapidă păstrează explicită o cale de apel doar de server.

URL- ul entității găzduitehttps://ffast.app

AutentificareX-API-Key: pending_activation_…

Profilul de clientFfastPipeline

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

Pentru siguranța acreditărilor, FFast verifică stocarea secretă pe partea de server înainte de a nu include nimic în pachetul client. Această verificare rapidă nu produce nici loguri publice, nici depozite clare.

Rezolvarea unui link

FFast abordează operațiunea Resolve prin detectarea sursei, apoi formatează dintr-un singur URL trimis. Revizuirea rapidă nu păstrează explicite ieșiri inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`fast_source`	URL HTTPS	Da.	Pagina media publică sau autorizată pentru a analiza.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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

Pentru identificatorul de format, FFast verifică valoarea returnată neschimbată înainte de disponibilitatea pentru fiecare link. Această verificare rapidă nu clarifică nici eticheta de calitate presupusă.

Crearea și urmărirea unei lucrări de descărcare

FFast gestionează crearea Job-ului prin identificarea mai întâi a pregătirii asincrone. Continuă cu o solicitare HTTP scurtă și ține în vedere execuția limitată a worker-ului.

POST/v1/jobsDomeniul de aplicare: locuri de muncă

Câmp	Tip	Obligatoriu	Descrierea
`fast_source`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`output_code`	șir	Da.	Un ID exact din răspunsul de rezolvare.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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 AcceptatSalvează pipeline_run.

2Starea sondajuluiGET /v1/jobs/{pipeline_run} cu aceeași cheie.

3Gata.Deschideți URL-ul de descărcare semnat.

Starea	Semnificație	Acțiune de client
`queued`	Admis în coada limitată.	Sondaj din nou cu backoff.
`extracting`	Reîmprospătarea metadatelor sursă sau a rutei.	Continuă să votezi.
`processing`	Descărcarea, remixarea sau îmbinarea.	Afișați progresul serverului.
`ready`	Descărcarea semnată este disponibilă.	Trimiteți URL-ul utilizatorului.
`failed`	Eroare structurată terminală.	Citiți `error_code`. Reîncercaţi numai atunci când este recomandat.
`expired`	Ieșirea temporară a fost eliminată.	Creați un loc de muncă nou.

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

Interogarea jobului începe cu o așteptare inițială de o secundă pe FFast. Următoarea vizualizare acoperă exponențiala cu limită. Pagina păstrează vizibilă livrarea temporară semnată.

Erori previzibile

Recenzia rapidă a FFast analizează un plic non-2xx pentru contractul de eroare. Afișează apoi un ID de solicitare de suport și nu ascunde gestionarea previzibilă de către 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	Semnificație tipică	Acțiune
400	URL nevalid, corp sau format indisponibil.	Corectați solicitarea. Rezolvați din nou pentru formate.
401	Cheie lipsă, nevalidă, expirată sau cu domeniu incorect.	Verificați acreditările de pe partea serverului.
403	Politica chiriașului sau a sursei a respins solicitarea.	Nu ocoliți politica. Contactați asistența.
404	Loc de muncă necunoscut sau expirat.	Creați un nou loc de muncă, dacă este cazul.
429	A fost atinsă limita de solicitări sau de lucrări active.	Onoare. `retry_after_seconds`.
503	Coada/capacitatea sau sursa din amonte sunt temporar indisponibile.	Reîncercați cu backoff exponențial și jitter.

Contract de exploatare

FFast activează cote măsurate care mențin transferul receptiv fără a pune o sarcină nesigură pe platformele din amonte.

Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
Utilizați backoff exponențial limitat cu jitter pentru 429, 503 şi erori reîncercabile.
Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.

FFast abordează accesul la Schema prin activare înainte de explorare, apoi autentificare asignată. Revizuirea rapidă păstrează explicite formele de cerere documentate.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Oferă FFast un rezumat concis al produsului, o proiecție a traficului și o listă a platformelor. Precizează dacă sunt necesare verificări ale metadatelor, joburi pregătite sau ambele, astfel încât cheia emisă să corespundă fluxului de lucru real.

Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.