Samo predogled – zahteva se aktivacija

Ustvarite prenose z FFast

FFast razkriva namenjeno obliko API-ja, ne da bi omogočil javne klice. Operater aktivira poverilnice in izmerjene kvote po pregledu predlagane integracije.

FfastPipelineJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

FFast se približa gostitelju API-ja prek poverilnic, ki jih aktivira podpora, nato pa dodeljeno končno točko najemnika. Hitri pregled ohranja izrecno pot klica samo v strežniku.

URL najemnikahttps://ffast.app

AvtentikacijaX-API-Key: pending_activation_…

Profil odjemalcaFfastPipeline

Različica 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"}'

Za varnost poverilnic FFast preveri shranjevanje skrivnosti na strežniški strani, preden ne vključi nobene odjemalske zbirke. Ta hitri pregled prav tako zagotavlja, da ni javnih dnevnikov ali repozitorijev.

Reši povezavo

FFast pristopa k operaciji Resolve preko zaznavanja vira, nato pa oblikuje iz enega poslanega URL-ja. Hitri pregled ne ohranja nobenih izmišljenih izhodov eksplicitno.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`fast_source`	HTTPS URL	Da.	Javna ali pooblaščena medijska stran za analizo.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

Za identifikator formata FFast preveri vrnjeno vrednost nespremenjeno pred razpoložljivostjo po povezavi. Ta hitri pregled prav tako ne naredi nobene domnevne oznake kakovosti jasne.

Ustvarjanje in spremljanje opravila prenosa

FFast upravlja ustvarjanje naloge tako, da najprej identificira asinhrono pripravo. Sledi kratka HTTP zahteva in ohranja omejeno izvajanje delavca v pogledu.

POST/v1/jobsObseg: delovna mesta

Polje	Vrsta	Zahtevano	Opis
`fast_source`	HTTPS URL	Da.	Isti normalizirani vir je bil poslan za rešitev.
`output_code`	niz	Da.	Natančna ID iz odziva reševanja.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

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

3PripravljenOdprite podpisan URL za prenos.

Stanje	Pomen	Dejanje stranke
`queued`	Sprejeto v omejeno čakalno vrsto.	Anketa znova z backoff.
`extracting`	Osveževanje metapodatkov vira ali poti.	Nadaljujte z glasovanjem.
`processing`	Prenos, remuxing ali združevanje.	Prikaz napredka strežnika.
`ready`	Podpisan prenos je na voljo.	Pošljite URL uporabniku.
`failed`	Napaka strukture terminala.	Preberi `error_code`Ponovite le, ko vam svetujemo.
`expired`	Začasni izhod je bil odstranjen.	Ustvarite novo delovno mesto.

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

Preverjanje nalog se začne z eno sekundo začetnega čakanja na FFast. Naslednji pogled zajema omejeno vračanje. Stran ohranja začasno podpisano dostavo vidno.

Predvidljive napake

Hitri pregled FFast pregleda eno ovojnico, ki ni 2xx, za pogodbo o napaki. Prikaže ID zahteve za podporo in ne zakriva predvidenega ravnanja odjemalca.

{
  "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čen pomen	Ukrepanje
400	Neveljaven URL, telo ali nedosegljiv format.	Popravite zahtevo. Ponovno rešite za formate.
401	Manjkajoč, neveljaven, potekel ali napačnega obsega ključ.	Preverite poverilnice na strani strežnika.
403	Najemnik ali izvorna politika sta zavrnila zahtevo.	Ne zaobidite politike. Kontaktirajte podporo.
404	Neznano ali poteklo delovno mesto.	Po potrebi ustvarite novo delovno mesto.
429	Dosežena omejitev zahtev ali aktivnih opravil.	Čast. `retry_after_seconds`.
503	Čakalna vrsta/zmogljivost ali zgornji tok začasno ni na voljo.	Poskusite znova z eksponentnim zamikom in naključnim odmikom.

Pogodba o obratovanju

FFast aktivira merjene kvote, ki ohranjajo odzivnost prenosa brez nevarne obremenitve zgornjih platform.

Uporabite idempotentno logiko aplikacije in nikoli ne zaženite podvojenih opravil za isti klik uporabnika.
Predpomnite metapodatke reševanja na kratko, vendar vedno obravnavajte podpisane URL-je za prenos kot potekle.
Uporabite omejen eksponentni povratek z motnjo za 429, 503 in ponovljive napake.
Obdelujte samo javne medije ali medije, do katerih imate dovoljen dostop. DRM in nadzori dostopa niso zaobšli.
Shranjujte ID-je zahtev in ID-je opravil v zasebnih operativnih dnevnikih. Ne beležite nepotrebno poslanih URL-jev.

FFast se približuje dostopu do sheme prek aktivacije pred raziskovanjem, nato pa dodeljeno preverjanje pristnosti. Hitri pregled ohranja dokumentirane oblike zahtev eksplicitne.

DOSTOP, KI GA PREGLEDUJE OPERATER

Aktivirajte prek podpore

Podajte FFast jedrnat povzetek izdelka, napoved prometa in seznam platform. Navedite, ali so potrebne preverjanja metapodatkov, pripravljene naloge ali oboje, da se izdan ključ ujema z dejanskim delovnim tokom.

Zahtevajte aktivacijo Ključi so omejeni na najemnika, preklicljivi in izdani prek kontaktnega obrazca. Anonimni skripti ne morejo izvajati nalog prenašalnika.