https://dwtt.appNgawangun unduhan sareng DWTT
DWTT nyebarkeun garis besar integrasi ieu pikeun perencanaan, sanés palaksanaan anonim. Dukungan kedah nyatujuan alur kerja klip sateuacan ngaluarkeun konci anu diwatesan sareng ijin lalulintasna.
DwttToolkitJSON ngalangkungan HTTPSPakaryan asinkronKredensial anu diwatesan
01
Mimitian gancang
DWTT ngajantenkeun host API gampang dipindai. Halaman dimimitian ku kredensial anu diaktipkeun ku dukungan, ngalih ka titik akhir panyewa anu ditugaskeun, sareng sacara jelas nyatakeun jalur telepon khusus server.
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 ngadeukeutan kaamanan Kredensial ngalangkungan panyimpenan rusiah sisi server, teras henteu aya embedding bundel klien. Alur kerja anu disederhanakeun henteu nyimpen log umum atanapi repository sacara eksplisit.
02
Ngarengsekeun hiji link
DWTT ngajantenkeun operasi Resolve gampang dipariksa. Halaman dimimitian ku deteksi sumber, ngalih ka format tina hiji URL anu dikintunkeun, sarta sacara jelas nyatakeun teu aya hasil anu diada-adakeun.
POST
/v1/resolveLingkup: ngarengsekeun| Medan | Tipe | Diperyogikeun | Katerangan |
|---|---|---|---|
source_link | 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
}DWTT ngadeukeutan identifier Format ngaliwatan nilai anu dipulangkeun tanpa robah, teras kasediaan per-link. Alur kerja anu disederhanakeun henteu ngajaga labél kualitas anu ditebak sacara eksplisit.
03
Nyiptakeun sareng nuturkeun padamelan unduhan
Dina DWTT, persiapan asinkron datang heula nalika ngajelaskeun nyiptakeun Pagawean. Alur kerja anu disederhanakeun nuturkeun pamundut HTTP pondok sareng ditutup ku palaksanaan pagawé anu diwatesan.
POST
/v1/jobsLingkup: padamelan| Medan | Tipe | Diperyogikeun | Katerangan |
|---|---|---|---|
source_link | URL HTTPS | Leres | Sumber normalisasi anu sami diserahkeun pikeun direngsekeun. |
format_ref | string | Leres | ID anu pasti tina réspon ngarengsekeun. |
tenant | string | Henteu | Ditugaskeun domain panyewa. Biasana dileungitkeun. |
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} kalayan konci anu sami.| 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://dwtt.app/v1/jobs/TASK_REF \
-H "X-API-Key: $DWTT_TOOL_TOKEN"Pikeun ngajelaskeun polling Job, DWTT misahkeun antosan awal hiji detik tina backoff anu diwatesan. Alur kerja anu disederhanakeun masihan pangiriman ditandatanganan samentawis tempat sorangan.
04
Kasalahan anu tiasa diprediksi
Hiji amplop non-2xx mangrupikeun titik awal pikeun kontrak Kasalahan dina DWTT. Alur kerja anu disederhanakeun teras nampilkeun ID pamundut dukungan sareng ngajelaskeun 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. |
05
Kontrak operasi
DWTT nyetél tunjangan lalu lintas nalika aktipkeun sahingga integrasi klip sareng jaringan sumber henteu dimuat teuing.
- 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,503sareng 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.
DWTT ngajantenkeun aksés Schema gampang pikeun dipindai. Halaman dimimitian ku aktivasi sateuacan eksplorasi, ngalih ka otentikasi anu ditugaskeun, sareng sacara jelas nyatakeun bentuk pamundut anu didokumentasikeun.
Aktipkeun ngalangkungan dukungan
Kirimkeun ka DWTT integrasi anu dimaksud, kamungkinan volume paménta sareng jaringan target. Sebutkeun naha klien peryogi résolusi, nyiptakeun padamelan atanapi duanana supados konci anu diwatesan tiasa disatujuan sareng ditingalikeun engké.
Kéngingkeun aktivasina Konci téh diwatesan ku panyewa, bisa dibatalkeun jeung dikaluarkeun ngaliwatan formulir Kontak. Skrip anonim teu bisa ngalaksanakeun pagawéan pangunduh.