Pralihat sahaja — pengaktifan diperlukan

Bina muat turun dengan EasyT

Rujukan EasyT ini adalah panduan pelaksanaan dan bukan titik akhir tanpa nama yang aktif. Akses pengeluaran bermula hanya selepas sokongan meluluskan klien dan menetapkan had.

EasytWorkspaceJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

Hos API bermula dengan sokongan diaktifkan kelayakan pada EasyT. Ini pemeriksaan panduan kemudian membentangkan titik akhir penyewa yang ditugaskan. Fakta akhir adalah laluan panggilan pelayan sahaja.

URL Penyewahttps://easyt.io

PengesahanX-API-Key: pending_activation_…

Profil PelangganEasytWorkspace

Versi APIv1

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

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

Dalam EasyT, penyimpanan rahsia sisi pelayan datang dahulu apabila menerangkan keselamatan Kredensial. Semakan berpandu itu diikuti tanpa penyertaan bundel klien dan ditutup tanpa log atau repositori awam.

Menyelesaikan pautan

Operasi penyelesaian bermula dengan pengesanan sumber pada EasyT. Pemeriksaan panduan ini kemudian membentangkan format dari satu URL yang dikemukakan. Fakta akhir adalah tiada output yang dicipta.

POST/v1/resolveSkop: menyelesaikan

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

Dalam EasyT, nilai yang dikembalikan tanpa perubahan muncul terlebih dahulu apabila menerangkan Pengenal Format. Pemeriksaan berpandu itu diikuti dengan ketersediaan setiap pautan dan ditutup tanpa label kualiti yang dianggarkan.

Cipta dan ikuti kerja muat turun

Persediaan asinkron adalah titik permulaan untuk Penciptaan Kerja pada EasyT. Semakan panduan kemudian membentangkan permintaan HTTP pendek dan menerangkan pelaksanaan pekerja yang dibatasi.

POST/v1/jobsSkop: pekerjaan

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

curl -X POST https://easyt.io/v1/jobs \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'

1202 DiterimaSimpan workspace_job.

2Status undianGET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

Untuk polling Job, EasyT bermula dengan menunggu awal satu saat. Semakan panduannya berpasangan yang dengan backoff berkapas dan berakhir dengan penghantaran sementara yang ditandatangani.

Kesalahan yang boleh diramalkan

EasyT menjadikan kontrak Ralat mudah untuk mengimbas. Halaman bermula dengan satu sampul surat bukan 2xx, bergerak ke ID permintaan sokongan, dan dengan jelas menyatakan pengendalian pelanggan yang dapat 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

EasyT memilih elaun operasi semasa semakan, mengimbangi keperluan aplikasi dengan kesihatan penyedia.

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.

Akses skema bermula dengan pengaktifan sebelum penerokaan pada EasyT. Pemeriksaan panduan ini kemudian membentangkan pengesahan yang ditugaskan. Fakta akhir adalah bentuk permintaan yang didokumentasikan.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Sertakan tujuan klien, beban kerja bulanan yang dijangka dan rangkaian yang diminta dalam nota pengaktifan. EasyT kemudian boleh memilih skop penyelesaian dan kerja dengan betul sebelum menghasilkan rahsia pandangan tunggal.

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