Samo pregled – potrebna je aktivacija

Izgradite preuzimanja s FFast

FFast izlaže predviđeni oblik API-ja bez uključivanja javnih poziva. Operater aktivira vjerodajnice i izmjerene kvote nakon pregleda predložene integracije.

FfastPipelineJSON preko HTTPS-aAsinkroni posloviVjerodajnice s opsegom

Brzi početak rada

FFast pristupa API domaćinu putem vjerodajnica aktiviranih podrškom, a zatim dodijeljenom krajnjom točkom najmoprimca Brzi pregled čuva izričit put poziva samo poslužitelja.

URL klijentahttps://ffast.app

AutentifikacijaX-API-Key: pending_activation_…

Profil klijentaFfastPipeline

Verzija API-jav1

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

Radi sigurnosti vjerodajnica, FFast provjerava pohranu tajni na strani poslužitelja prije nego što ih ugradi u klijentski paket. Ovaj brzi pregled također ne čisti javne zapisnike ni repozitorije.

Rješavanje veze

FFast pristupa operaciji Resolve kroz otkrivanje izvora, a zatim formate s jednog predanog URL-a. Brzi pregled ne čuva izmišljene izlaze eksplicitno.

POST/v1/resolveOpseg: riješiti

Polje	Tip	Obvezno	Opis
`fast_source`	HTTPS URL	Da	Javna ili ovlaštena medijska stranica za analizu.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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

Za Format identifikator, FFast provjerava vraćenu vrijednost nepromijenjenu prije dostupnosti po vezi. Ovaj brzi pregled također čini da nijedan nagađani kvalitetni natpis nije jasan.

Stvaranje i praćenje zadatka preuzimanja

FFast obrađuje stvaranje zadatka tako što prvo identificira asinkronu pripremu. Slijedi s kratkim HTTP zahtjevom i drži izvršavanje ograničenog radnika u vidu.

POST/v1/jobsPodručje primjene: poslovi

Polje	Tip	Obvezno	Opis
`fast_source`	HTTPS URL	Da	Isti normalizirani izvor predan za rješavanje.
`output_code`	string	Da	Točan ID iz odgovora na rješavanje.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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 PrihvaćenoSpremi pipeline_run.

2Status anketeGET /v1/jobs/{pipeline_run} istim ključem.

3SpremniOtvorite potpisani URL za preuzimanje.

Status	Značenje	Akcija klijenta
`queued`	Prihvaćeno u ograničeni red.	Ponovno anketiranje s odmakom.
`extracting`	Osvježavanje izvornih metapodataka ili rute.	Nastavite s glasovanjem.
`processing`	Preuzimanje, remiksanje ili spajanje.	Prikaz napretka poslužitelja.
`ready`	Potpisano preuzimanje je dostupno.	Pošaljite URL korisniku.
`failed`	Terminal strukturirana pogreška.	Pročitajte `error_code`. Ponovite samo kada se savjetuje.
`expired`	Privremeni izlaz je uklonjen.	Stvorite novi posao.

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

Anketiranje zadatka započinje s početnim čekanjem od jedne sekunde na FFast. Sljedeći prikaz pokriva ograničeni backoff. Stranica zadržava privremenu potpisanu isporuku vidljivom.

Predvidljive pogreške

Brzi pregled FFast-a pregledava jednu ne-2xx omotnicu za ugovor o pogrešci. Prikazuje ID zahtjeva za podršku uz to i ne zaklanja predvidljivo rukovanje na strani klijenta.

{
  "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	Tipično značenje	Akcija
400	Nevažeći URL, tijelo ili nedostupan format.	Ispravite zahtjev. Resolvirajte ponovno za formate.
401	Ključ nedostaje, nije valjan, istekao je ili ima pogrešan opseg.	Provjerite vjerodajnice na strani poslužitelja.
403	Zahtjev je odbio stanar ili izvorno pravilo.	Nemojte zaobići pravilnik. Kontaktirajte podršku.
404	Nepoznat ili istekao posao.	Stvorite novi posao ako je to prikladno.
429	Dostignuto je ograničenje zahtjeva ili aktivnih zadataka.	Čast `retry_after_seconds`.
503	Red čekanja/kapaciteta ili upstream privremeno nedostupan.	Pokušajte ponovno s eksponencijalnim backoff i jitter.

Ugovor o radu

FFast aktivira mjerene kvote koje održavaju odzivnost prijenosa bez stvaranja nesigurnog opterećenja na platformama uzvodno.

Koristite idempotentnu logiku aplikacije i nikada ne pokrenite duplicirane poslove za isti klik korisnika.
Predmemorija rješava metapodatke kratko, ali uvijek tretira potpisane URL-ove za preuzimanje kao isteka.
Koristite ograničeni eksponencijalni backoff s jitterom za 429, 503 i ponovljive pogreške.
Obrađujte samo javne medije ili medije za koje imate ovlaštenje pristupa. DRM i kontrole pristupa nisu zaobiđene.
ID-ove zahtjeva i ID-ove poslova čuvajte u privatnim operativnim zapisnicima. Nemojte nepotrebno bilježiti poslane URL-ove.

FFast pristupa pristupu Shemi putem aktivacije prije istraživanja, a zatim dodijeljene autentifikacije. Brzi pregled održava dokumentirane oblike zahtjeva izričitima.

PRISTUP KOJI PREGLEDA OPERATER

Aktivirajte se putem podrške

Daj FFast sažet sažetak proizvoda, projekcija prometa i popis platformi. Navedite jesu li potrebne provjere metapodataka, pripremljeni poslovi ili oboje kako bi izdani ključ odgovarao stvarnom tijeku rada.

Zatražite aktivaciju Ključevi su ograničeni na zakupca, opozivi su mogući i izdaju se putem obrasca za kontakt. Anonimni skripti ne mogu izvršavati preuzimanje radova.