Ngan ukur preview — aktivasina diperyogikeun

Ngawangun unduhan sareng FFast

FFast nembongkeun bentuk API anu dimaksud tanpa ngaktipkeun telepon umum. Operator ngaktipkeun kredensial sareng kuota anu diukur saatos mariksa integrasi anu diusulkeun.

FfastPipelineJSON ngalangkungan HTTPSPakaryan asinkronKredensial anu diwatesan

Mimitian gancang

FFast ngadeukeutan host API ngaliwatan kredensial anu diaktipkeun ku dukungan, teras titik akhir tenant anu ditugaskeun. Tinjauan gancang ngajaga jalur telepon server-wungkul sacara eksplisit.

URL panyewahttps://ffast.app

AuténtikasiX-API-Key: pending_activation_…

Profil klienFfastPipeline

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

Pikeun kaamanan Kredensial, FFast mariksa panyimpenan rusiah sisi server sateuacan henteu ngalebetkeun bundel klien. Tinjauan gancang ieu ogé henteu nyieun log umum atanapi repository anu jelas.

Ngarengsekeun hiji link

FFast ngadeukeutan operasi Resolve ngalangkungan deteksi sumber, teras ngformat tina hiji URL anu dikintunkeun. Tinjauan gancang henteu nyimpen hasil anu diada-adakeun sacara eksplisit.

POST/v1/resolveLingkup: ngarengsekeun

Medan	Tipe	Diperyogikeun	Katerangan
`fast_source`	URL HTTPS	Leres	Halaman média umum atanapi anu diidinan pikeun dianalisis.
`tenant`	string	Henteu	Ditugaskeun domain panyewa. Biasana dileungitkeun.

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

Pikeun idéntifikasi Format, FFast mariksa nilai anu dipulangkeun tanpa robah sateuacan kasadiaan per-link. Tinjauan gancang ieu ogé henteu ngajelaskeun labél kualitas anu diperkirakeun.

Nyiptakeun sareng nuturkeun padamelan unduhan

FFast ngatur nyiptakeun Job ku mimiti ngaidentipikasi persiapan asinkron. Teras nuturkeun ku pamundut HTTP pondok sareng ngajaga palaksanaan pagawé anu diwatesan dina pandangan.

POST/v1/jobsLingkup: padamelan

Medan	Tipe	Diperyogikeun	Katerangan
`fast_source`	URL HTTPS	Leres	Sumber normalisasi anu sami diserahkeun pikeun direngsekeun.
`output_code`	string	Leres	ID anu pasti tina réspon ngarengsekeun.
`tenant`	string	Henteu	Ditugaskeun domain panyewa. Biasana dileungitkeun.

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

2Status pollingGET /v1/jobs/{pipeline_run} kalayan konci anu sami.

3SiapBuka URL unduhan anu ditandatanganan.

Status	Harti	Tindakan klien
`queued`	Ditampi kana antrian anu diwatesan.	Poll deui sareng backoff.
`extracting`	Ngarefresh metadata sumber atanapi rute.	Teruskeun polling.
`processing`	Ngaunduh, remuxing atanapi ngahijikeun.	Tampilan kamajuan server.
`ready`	Unduh anu ditandatanganan sayogi.	Kirimkeun URL ka pangguna.
`failed`	Kasalahan struktur terminal.	Baca `error_code`. Coba deui ngan ukur nalika disarankeun.
`expired`	Kaluaran samentawis dipiceun.	Nyiptakeun padamelan anyar.

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

Polling padamelan dimimitian ku ngantosan awal hiji detik dina FFast. Tampilan salajengna nutupan capped backoff. Halaman tetep kiriman anu ditandatanganan samentawis katingali.

Kasalahan anu tiasa diprediksi

Tinjauan gancang FFast marios hiji amplop non-2xx pikeun kontrak Kasalahan. Ieu nunjukkeun ID pamundut dukungan salajengna sareng henteu nyumputkeun pangaturan klien anu tiasa diprediksi.

{
  "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	Harti anu khas	Aksi
400	URL anu henteu valid, awak atanapi format anu teu aya.	Ngabenerkeun pamundut. Ngarengsekeun deui pikeun format.
401	Konci leungit, henteu valid, kadaluarsa atanapi salah-ruang lingkup.	Pariksa kredensial sisi server.
403	Panyewa atanapi kabijakan sumber nolak pamundut.	Ulah bypass kawijakan. Hubungi rojongan.
404	Pakaryan anu teu dikenal atanapi kadaluarsana.	Nyiptakeun padamelan énggal upami cocog.
429	Kéngingkeun atanapi aktip-pakaryan wates ngahontal.	Honor `retry_after_seconds`.
503	Antrian/kapasitas atawa upstream keur teu aya samentara.	Coba deui sareng backoff éksponénsial sareng jitter.

Kontrak operasi

FFast ngaktipkeun kuota anu kaukur supaya prosés pamindahan tetep résponsif tanpa nambahan beban anu teu aman kana platform sumber.

Anggo logika aplikasi idempotent sareng henteu kantos ngamimitian padamelan duplikat pikeun pangguna anu sami klik.
Cache metadata résolusi sacara singget, tapi sok anggap URL unduhan anu ditandatanganan salaku kadaluwarsa.
Anggo backoff éksponénsial anu dibatesan sareng jitter pikeun 429, 503 sareng kasalahan anu tiasa diusahakeun deui.
Ngolah ngan ukur média umum atanapi média anu anjeun diidinan pikeun ngaksés. DRM sareng kontrol aksés henteu dipaliré.
Ngajaga ID pamundut sareng ID padamelan dina log operasi pribadi. Ulah log URL anu dikirimkeun tanpa perlu.

FFast ngadeukeutan aksés Schema ngaliwatan aktivasi sateuacan eksplorasi, teras otentikasi anu ditugaskeun. Tinjauan gancang ngajaga bentuk pamundut anu didokumentasikeun sacara eksplisit.

AKSES DIPANGKEUN OPERATOR

Aktipkeun ngalangkungan dukungan

Pasihan FFast ringkesan produk anu singget, proyéksi lalulintas sareng daptar platform. Nyatakeun naha pamariksaan metadata, padamelan anu disiapkeun atanapi duanana diperyogikeun supados konci anu diterbitkeun cocog sareng alur kerja anu sabenerna.

Kéngingkeun aktivasina Konci téh diwatesan ku panyewa, bisa dibatalkeun jeung dikaluarkeun ngaliwatan formulir Kontak. Skrip anonim teu bisa ngalaksanakeun pagawéan pangunduh.