https://dwtt.appBina muat turun dengan DWTT
DWTT menerbitkan garis besar integrasi ini untuk perancangan, bukan pelaksanaan tanpa nama. Sokongan mesti meluluskan aliran kerja klip sebelum mengeluarkan kunci yang diskop dan elaun lalu lintasnya.
DwttToolkitJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan
01
Mulakan dengan cepat
DWTT menjadikan hos API mudah untuk mengimbas. Halaman bermula dengan kelayakan yang diaktifkan sokongan, bergerak ke titik akhir penyewa yang ditugaskan, dan dengan jelas menyatakan laluan panggilan pelayan sahaja.
X-API-Key: pending_activation_…DwttToolkitv1# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"
curl -X POST https://dwtt.app/v1/resolve \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'DWTT mendekati keselamatan Credential melalui penyimpanan rahsia sisi pelayan, kemudian tiada penempatan bundle pelanggan. Aliran kerja yang disempurnakan tidak menyimpan log awam atau repositori yang jelas.
02
Menyelesaikan pautan
DWTT menjadikan operasi Resolve mudah untuk diimbas. Halaman bermula dengan pengesanan sumber, bergerak ke format dari satu URL yang dikemukakan, dan dengan jelas menyatakan tiada output yang dicipta.
POST
/v1/resolveSkop: menyelesaikan| Medan | Jenis | Diperlukan | Huraian |
|---|---|---|---|
source_link | 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
}DWTT mendekati Pengenal Format melalui nilai yang dikembalikan tidak berubah, kemudian ketersediaan per pautan. Aliran kerja yang disempurnakan menyimpan label kualiti yang tidak ditebak secara eksplisit.
03
Cipta dan ikuti kerja muat turun
Dalam DWTT, persediaan asynchronous datang pertama apabila menerangkan Penciptaan Kerja. Aliran kerja yang disempurnakan itu mengikuti dengan permintaan HTTP pendek dan menutup pada pelaksanaan pekerja yang dibatasi.
POST
/v1/jobsSkop: pekerjaan| Medan | Jenis | Diperlukan | Huraian |
|---|---|---|---|
source_link | URL HTTPS | Ya | Sumber yang sama dinormalisasi dihantar untuk menyelesaikan. |
format_ref | rentetan | Ya | ID yang tepat dari respons penyelesaian. |
tenant | rentetan | Tidak | Domain penyewa yang ditugaskan. Biasanya ditinggalkan. |
curl -X POST https://dwtt.app/v1/jobs \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'task_ref.GET /v1/jobs/{task_ref} dengan kunci yang sama.| 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://dwtt.app/v1/jobs/TASK_REF \
-H "X-API-Key: $DWTT_TOOL_TOKEN"Untuk menerangkan polling Job, DWTT memisahkan menunggu awal satu saat dari backoff yang dicap. Aliran kerja yang disempurnakan memberikan penghantaran sementara yang ditandatangani tempatnya sendiri.
04
Kesalahan yang boleh diramalkan
Satu sampul surat bukan 2xx adalah titik permulaan untuk Kontrak ralat pada DWTT. Aliran kerja yang disempurnakan kemudian membentangkan ID permintaan sokongan dan menerangkan 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. |
05
Kontrak operasi
DWTT menetapkan elaun lalu lintas semasa pengaktifan supaya integrasi klip dan rangkaian sumber tidak terbeban.
- 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,503dan 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.
DWTT menjadikan akses Schema mudah untuk mengimbas. Halaman bermula dengan pengaktifan sebelum penerokaan, bergerak ke pengesahan yang ditugaskan, dan dengan jelas menyatakan bentuk permintaan yang didokumentasikan.
Aktifkan melalui sokongan
Hantar DWTT integrasi yang dimaksudkan, kemungkinan permintaan jumlah dan rangkaian sasaran. Sebutkan sama ada pelanggan memerlukan resolusi, penciptaan pekerjaan atau kedua-duanya supaya kunci yang diskop dapat diluluskan dan ditunjukkan sekali.
Minta pengaktifan Kunci adalah skop penyewa, boleh dibatalkan dan dikeluarkan melalui borang Hubungi. Skrip tanpa nama tidak dapat melaksanakan kerja pemuat turun.