Pouze náhled — vyžaduje aktivaci

Sestavte stahování s FFast

FFast odhaluje zamýšlený tvar API, aniž by zapínal veřejná volání. Operátor aktivuje přihlašovací údaje a stanovené kvóty po posouzení navrhované integrace.

FfastPipelineJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

FFast přistupuje k hostiteli API prostřednictvím přihlašovacích údajů aktivovaných podporou a poté přes přidělený koncový bod tenanta. Rychlá kontrola zachovává explicitní pouze serverovou cestu volání.

URL klientahttps://ffast.app

AutentizaceX-API-Key: pending_activation_…

Profil klientaFfastPipeline

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

Z důvodu bezpečnosti přihlašovacích údajů FFast před vložením do klientského balíčku kontroluje serverové úložiště tajných údajů. Tato rychlá kontrola také nezpřístupňuje žádné veřejné protokoly ani repozitáře.

Vyřešit odkaz

FFast přistupuje k operaci Resolve prostřednictvím detekce zdroje, poté formátuje z jednoho odeslaného URL. Rychlý přehled neuchovává žádné vymyšlené výstupy explicitně.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`fast_source`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

Pro identifikátor formátu FFast kontroluje vrácenou hodnotu beze změny před dostupností pro každý odkaz. Tato rychlá kontrola také nevyjasňuje žádné odhadované označení kvality.

Vytvoření a sledování úlohy stahování

FFast zpracovává vytváření úloh tak, že nejprve identifikuje asynchronní přípravu. Poté následuje krátký HTTP požadavek a průběžně sleduje omezené spuštění pracovníků.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`fast_source`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`output_code`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave pipeline_run.

2Stav hlasováníGET /v1/jobs/{pipeline_run} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

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

Polling úloh začíná jednosekundovým počátečním čekáním na FFast. Další zobrazení pokrývá omezený backoff. Stránka udržuje dočasné podepsané doručení viditelné.

Předvídatelné chyby

FFast rychlá kontrola kontroluje jednu obálku non-2xx pro Chyba smlouvy. Zobrazuje ID žádosti o podporu vedle a nezakrývá předvídatelné zpracování klienta.

{
  "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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

FFast aktivuje měřené kvóty, které udržují odevzdání citlivé, aniž by na platformách proti proudu vytvářely nebezpečné zatížení.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

FFast přistupuje ke Schema access prostřednictvím aktivace před průzkumem, poté přiřazené autentizace. Rychlá kontrola zachovává explicitní zdokumentované tvary požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Poskytněte FFast stručné shrnutí produktu, odhad návštěvnosti a seznam platforem. Uveďte, zda jsou potřeba kontroly metadat, připravené úlohy, nebo obojí, aby vydaný klíč odpovídal skutečnému pracovnímu postupu.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.