Pralihat sahaja — pengaktifan diperlukan

Bina muat turun dengan EasyF

EasyF menunjukkan antara muka terlebih dahulu supaya pemaju dapat menganggarkan kerja mereka. Semakan sokongan masih diperlukan sebelum kunci hidup dan sempadan penggunaan wujud.

EasyfClientJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

Untuk menerangkan hos API, EasyF memisahkan kelayakan yang diaktifkan sokongan daripada titik akhir penyewa yang ditetapkan. Aliran kerja bahasa mudah memberikan laluan panggilan hanya pelayan tempatnya sendiri.

URL Penyewahttps://easyf.app

PengesahanX-API-Key: pending_activation_…

Profil PelangganEasyfClient

Versi APIv1

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

curl -X POST https://easyf.app/v1/resolve \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Keselamatan kelayakan bermula dengan penyimpanan rahsia sisi pelayan pada EasyF. Pandangan seterusnya merangkumi tiada penyematan bundel klien. Halaman tidak menyimpan log awam atau repositori yang kelihatan.

Menyelesaikan pautan

Untuk menerangkan operasi Resolve, EasyF memisahkan pengesanan sumber dari format dari satu URL yang dihantar. Aliran kerja bahasa mudah tidak memberikan output ciptaan tempatnya sendiri.

POST/v1/resolveSkop: menyelesaikan

Medan	Jenis	Diperlukan	Huraian
`asset_url`	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
}

Pengenal format bermula dengan nilai yang dikembalikan tidak berubah pada EasyF. Pandangan seterusnya merangkumi ketersediaan per pautan. Halaman menyimpan tiada label kualiti yang ditebak kelihatan.

Cipta dan ikuti kerja muat turun

EasyF mempersembahkan tiga perkara praktikal untuk penciptaan Kerja. Pertama adalah persiapan tak segerak. Aliran kerja bahasa mudah kemudian merangkumi permintaan HTTP pendek. Titik akhirnya adalah pelaksanaan pekerja terhad.

POST/v1/jobsSkop: pekerjaan

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

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 DiterimaSimpan delivery_id.

2Status undianGET /v1/jobs/{delivery_id} 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://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF mendekati polling Kerja melalui menunggu awal satu saat, kemudian capped backoff. Aliran kerja bahasa biasa menyimpan penghantaran bertandatangan sementara yang eksplisit.

Kesalahan yang boleh diramalkan

EasyF mengatur kontrak Ralat sekitar satu sampul bukan 2xx. Aliran kerja bahasa mudahnya membandingkan ID permintaan sokongan. Pengendalian klien yang boleh diramal kekal sebagai pemeriksaan terakhir.

{
  "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

EasyF bersetuju dengan batasan penggunaan praktikal dengan setiap produk yang diluluskan untuk memelihara aliran kerja panduan yang boleh diramalkan.

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.

Untuk menerangkan akses Skema, EasyF memisahkan pengaktifan sebelum penerokaan daripada pengesahan yang ditetapkan. Aliran kerja bahasa mudah memberikan bentuk permintaan yang didokumentasikan tempatnya sendiri.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Beritahu EasyF apa yang anda bina, seberapa kerap ia akan memanggil API dan penyedia mana yang penting. Semakan menentukan operasi yang dibenarkan, kemudian mendedahkan kelayakan sekali sahaja sambil menyimpan hanya ringkasan selamatnya.

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