Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset DWTT: llä

DWTT julkaisee tämän integraatiokuvauksen suunnittelua varten, ei anonyymiin käyttöön. Tuen on hyväksyttävä videoiden käsittelytapa ennen rajatun avaimen ja siihen liittyvän liikennekiintiön myöntämistä.

DwttToolkitJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

DWTT kuvaa API-palvelimen käytön selkeästi: tuki aktivoi tunnistetiedot, asiakkaalle osoitetaan oma päätepiste ja kutsut tehdään vain palvelimelta.

Vuokraajan URL- osoitehttps://dwtt.app

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliDwttToolkit

API-versiov1

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

Palvelun DWTT tunnistetiedot säilytetään salaisuuksina palvelimella. Niitä ei sisällytetä asiakasohjelman tiedostoihin eikä julkisiin lokeihin tai koodivarastoihin.

Linkin ratkaiseminen

DWTT kuvaa linkin tietojen selvittämisen selkeästi: ensin tunnistetaan lähde ja sitten haetaan yhdelle lähetetylle osoitteelle saatavilla olevat muodot. Tuloksia ei keksitä.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`source_link`	HTTPS- URL	- Kyllä.	Julkinen tai valtuutettu mediapohja analysoitavaksi.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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

Palvelussa DWTT muodon tunnistetta käytetään sellaisena kuin se palautetaan. Saatavuus tarkistetaan linkkikohtaisesti, eikä laatumerkintöjä arvata.

Luo ja seuraa lataustehtävää

Tehtävän luomista kuvatessaan DWTT aloittaa asynkronisesta valmistelusta. Suoraviivainen työnkulku jatkuu lyhyellä HTTP-pyynnöllä ja päättyy käsittelijän rajattuun suoritukseen.

POSTI/v1/jobsLaajuus: työpaikat

Kenttä	Tyyppi	Pakollinen	Kuvaus
`source_link`	HTTPS- URL	- Kyllä.	Sama normalisoitu lähde lähetetty ratkaistavaksi.
`format_ref`	merkkijono	- Kyllä.	Tarkka tunnus ratkaisuvasteesta.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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

1202 HyväksyttyTallenna task_ref.

2Kyselyn tilaGET /v1/jobs/{task_ref} samalla avaimella.

3Valmiina.Avaa allekirjoitettu lataus-URL.

Tila	Merkitys	Asiakastoiminta
`queued`	Pääsi rajattuun jonoon.	Kysely uudelleen takaisinvedolla.
`extracting`	Päivitetään lähdemetatietoja tai reittiä.	Jatka äänestystä.
`processing`	Ladataan, remuxataan tai yhdistetään.	Näytä palvelimen edistyminen.
`ready`	Allekirjoitettu lataus on saatavilla.	Lähetä URL-osoite käyttäjälle.
`failed`	Päätelaitteen rakenteellinen virhe.	Lue `error_code`Yritä uudelleen vain, kun sitä kehotetaan.
`expired`	Väliaikainen tuotos poistettiin.	Luo uusi työpaikka.

curl https://dwtt.app/v1/jobs/TASK_REF \
  -H "X-API-Key: $DWTT_TOOL_TOKEN"

Palvelun DWTT tehtävän tilan kyselyissä ensimmäinen odotus on yksi sekunti. Sen jälkeen kyselyväliä kasvatetaan määritettyyn enimmäisrajaan asti. Väliaikainen allekirjoitettu latauslinkki käsitellään erikseen.

Ennustettavat virheet

Palvelun DWTT virhevastauksissa käytetään yhtenäistä vastausrakennetta HTTP-tilakoodeille, jotka eivät kuulu 2xx-ryhmään. Vastauksessa annetaan tukipyyntöä varten pyynnön tunniste, jotta asiakasohjelma voi käsitellä virheet ennakoitavasti.

{
  "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	Tyypillinen merkitys	Toimi
400	Virheellinen URL-osoite, sisältö tai formaatti ei ole saatavilla.	Korjaa pyyntö. Ratkaise uudelleen formaateille.
401	Puuttuva, virheellinen, vanhentunut tai väärän laajuuden avain.	Tarkista palvelinpuolen tunnistetiedot.
403	Vuokralaisen tai lähdepolitiikan pyyntö hylättiin.	Älä ohita käytäntöä. Ota yhteyttä tukeen.
404	Tuntematon tai vanhentunut työpaikka.	Luo uusi tehtävä, jos tarpeen.
429	Pyyntö- tai aktiivisten tehtävien raja saavutettu.	Kunnia. `retry_after_seconds`.
503	Jono/kapasiteetti tai ylävirta tilapäisesti poissa käytöstä.	Yritä uudelleen eksponentiaalisella viiveellä ja häiriöllä.

Toiminnan sopimus

DWTT asettaa liikennekiintiöt käyttöönoton aikana, jotta leikeintegraatiot ja lähdeverkot eivät ylikuormitu.

Käytä idempotenttia sovelluslogiikkaa äläkä koskaan käynnistä päällekkäisiä tehtäviä saman käyttäjän klikkauksesta.
Välimuisti ratkaisee metatiedot lyhyesti, mutta käsittelee aina allekirjoitettuja lataus-URL-osoitteita vanhenevina.
Käytä rajattua eksponentiaalista takaisinkytkentää häiriöllä varten 429, 503 ja uudelleenyritettävä virheitä.
Käsittele vain julkista mediaa tai mediaa, johon sinulla on oikeus. DRM- ja käyttöoikeusrajoituksia ei kiertää.
Pidä pyyntö- ja työn tunnukset yksityisissä toimintalokeissa. Älä kirjaa lähetettyjä URL-osoitteita tarpeettomasti.

DWTT kuvaa rajapintaskeeman käytön selkeästi: käyttö aktivoidaan ennen tutustumista, käyttäjälle annetaan tunnistautumistiedot ja pyyntöjen rakenteet dokumentoidaan.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Lähetä palvelulle DWTT tiedot suunnitellusta integraatiosta, arvioidusta pyyntömäärästä ja kohdeverkostoista. Kerro, tarvitseeko asiakasohjelma linkin tietojen selvittämistä, tehtävien luomista vai molempia. Näin rajattu avain voidaan hyväksyä ja näyttää kerran.

Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.