Pralihat sahaja — pengaktifan diperlukan

Bina muat turun dengan FFast

FFast mendedahkan bentuk API yang dimaksudkan tanpa mengaktifkan panggilan awam. Seorang pengendali mengaktifkan kredensial dan kuota yang diukur selepas memeriksa integrasi yang dicadangkan.

FfastPipelineJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

FFast mendekati hos API melalui kelayakan yang diaktifkan sokongan, kemudian titik akhir penyewa yang ditetapkan. Semakan pantas mengekalkan laluan panggilan hanya pelayan dengan jelas.

URL Penyewahttps://ffast.app

PengesahanX-API-Key: pending_activation_…

Profil PelangganFfastPipeline

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

Untuk keselamatan Kredensial, FFast memeriksa penyimpanan rahsia sisi pelayan sebelum tiada penyisipan bundel klien. Semakan pantas ini juga memastikan tiada log awam atau repositori yang jelas.

Menyelesaikan pautan

FFast mendekati Operasi Penyelesaian melalui pengesanan sumber, kemudian format dari satu URL yang dikemukakan. Ulasan cepat menyimpan tiada keluaran yang dicipta secara eksplisit.

POST/v1/resolveSkop: menyelesaikan

Medan	Jenis	Diperlukan	Huraian
`fast_source`	URL HTTPS	Ya	Halaman media awam atau yang dibenarkan untuk dianalisis.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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

Untuk pengenal Format, FFast memeriksa nilai yang dikembalikan tidak berubah sebelum ketersediaan per pautan. Ulasan cepat ini juga membuat tidak ada label kualiti yang ditebak jelas.

Cipta dan ikuti kerja muat turun

FFast mengendalikan penciptaan Kerja dengan pertama mengenal pasti persediaan asinkron. Ia mengikuti dengan permintaan HTTP pendek dan menyimpan pelaksanaan pekerja yang dibatasi dalam pandangan.

POST/v1/jobsSkop: pekerjaan

Medan	Jenis	Diperlukan	Huraian
`fast_source`	URL HTTPS	Ya	Sumber yang sama dinormalisasi dihantar untuk menyelesaikan.
`output_code`	rentetan	Ya	ID yang tepat dari respons penyelesaian.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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

2Status undianGET /v1/jobs/{pipeline_run} dengan kunci yang sama.

3SediaBuka URL muat turun yang ditandatangani.

Status	Makna	Tindakan Pelanggan
`queued`	Dibenarkan masuk ke barisan yang dibatasi.	Poll lagi dengan backoff.
`extracting`	Menyegar semula metadata sumber atau laluan.	Teruskan mengundi.
`processing`	Memuat turun, remuxing atau menggabungkan.	Papar kemajuan pelayan.
`ready`	Muat turun yang ditandatangani tersedia.	Hantar URL kepada pengguna.
`failed`	Ralat berstruktur terminal.	Baca `error_code`. Cuba semula hanya apabila dinasihatkan.
`expired`	Keluaran sementara dikeluarkan.	Cipta pekerjaan baru.

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

Polling kerja bermula dengan menunggu awal satu saat pada FFast. Pandangan seterusnya meliputi backoff berkapas. Halaman menyimpan penghantaran bertandatangan sementara yang dapat dilihat.

Kesalahan yang boleh diramalkan

Ulasan cepat FFast mengkaji satu sampul surat bukan 2xx untuk kontrak Ralat. Ia menunjukkan ID permintaan sokongan seterusnya dan tidak menutupi pengendalian pelanggan yang boleh diramalkan.

{
  "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	Makna biasa	Tindakan
400	URL tidak sah, badan atau format tidak tersedia.	Betulkan permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak sah, tamat tempoh atau salah skop.	Semak kelayakan sisi pelayan.
403	Polisi penyewa atau sumber menolak permintaan.	Jangan mengelirukan dasar Hubungi sokongan.
404	Kerja yang tidak diketahui atau tamat tempoh.	Buat kerja baru jika sesuai.
429	Permintaan atau had aktif-kerja telah dicapai.	Kehormatan `retry_after_seconds`.
503	Baris gilir/kapasiti atau upstream tidak tersedia buat sementara waktu.	Cuba lagi dengan backoff eksponen dan jitter.

Kontrak operasi

FFast mengaktifkan kuota yang diukur yang memastikan penyerahan tetap responsif tanpa meletakkan beban tidak selamat pada platform hulu.

Gunakan logik aplikasi idempotent dan jangan pernah memulakan kerja berganda untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara ringkas, tetapi sentiasa merawat URL muat turun yang ditandatangani sebagai tamat tempoh.
Gunakan backoff eksponen yang dibatasi dengan jitter untuk 429, 503 dan kesilapan yang boleh dicuba semula.
Proses hanya media awam atau media yang anda dibenarkan untuk mengakses. DRM dan kawalan akses tidak dipintas.
Simpan ID permintaan dan ID kerja dalam log operasi peribadi. Jangan log URL yang dihantar tanpa perlu.

FFast mendekati akses Skema melalui pengaktifan sebelum penerokaan, kemudian pengesahan yang ditetapkan. Semakan pantas mengekalkan bentuk permintaan yang didokumenkan dengan jelas.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Berikan FFast ringkasan produk yang ringkas, unjuran lalu lintas dan senarai platform. Nyatakan sama ada pemeriksaan metadata, pekerjaan yang disediakan atau kedua-duanya diperlukan supaya kunci yang dikeluarkan sepadan dengan aliran kerja sebenar.

Minta pengaktifan Kunci adalah skop penyewa, boleh dibatalkan dan dikeluarkan melalui borang Hubungi. Skrip tanpa nama tidak dapat melaksanakan kerja pemuat turun.