Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset DWYT: llä

Palvelun DWYT koodiesimerkit kuvaavat tulevan pyyntöketjun. Tuotantokutsut pysyvät suljettuina, kunnes videosovellus on tarkistettu ja ylläpitäjän myöntämät tunnistetiedot on aktivoitu.

DwytFlowJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

Palvelussa DWYT API-palvelimen käyttö alkaa tuen aktivoimista tunnistetiedoista. Sen jälkeen käytetään asiakkaalle osoitettua päätepistettä. Kutsut tehdään vain palvelimelta.

Vuokraajan URL- osoitehttps://dwyt.app

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliDwytFlow

API-versiov1

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

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

Palvelussa DWYT salaiset tunnistetiedot säilytetään palvelimella. Niitä ei sisällytetä asiakasohjelman tiedostoihin eikä julkisiin lokeihin tai koodivarastoihin.

Linkin ratkaiseminen

Palvelussa DWYT linkin tietojen selvittäminen alkaa lähteen tunnistuksesta. Sen jälkeen näytetään yhdelle lähetetylle osoitteelle saatavilla olevat muodot. Tuloksia ei keksitä.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`public_media`	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 DWYT muodon tunnistetta käytetään sellaisena kuin se palautetaan. Saatavuus tarkistetaan linkkikohtaisesti, eikä laatumerkintöjä arvata.

Luo ja seuraa lataustehtävää

Työn luomisessa DWYT tarkistaa asynkronisen valmistelun ennen lyhyttä HTTP-pyynnön suorittamista. Tämä formaattikartta tekee myös rajatun työntekijäsuorituksen selväksi.

POSTI/v1/jobsLaajuus: työpaikat

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

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

1202 HyväksyttyTallenna flow_id.

2Kyselyn tilaGET /v1/jobs/{flow_id} 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://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

Palvelussa DWYT tehtävän tilan kysely alkaa yhden sekunnin odotuksella. Sen jälkeen kyselyväliä kasvatetaan määritettyyn enimmäisrajaan asti. Tiedosto toimitetaan väliaikaisella allekirjoitetulla latauslinkillä.

Ennustettavat virheet

Palvelun DWYT 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

DWYT tarkistaa integraation ennen kuin valitsee kiintiöt, jotka suojaavat sekä videoasiakasta että ylävirran palveluita.

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.

Palvelussa DWYT rajapintaskeeman käyttö aktivoidaan ennen tutustumista. Sen jälkeen käytetään annettuja tunnistautumistietoja ja dokumentoituja pyyntörakenteita.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Kuvaile pyynnön taustalla oleva sovellus, arvioitu kuukausiliikenne ja käytettävät videopalvelut. DWYT tarkistaa tiedot ja myöntää tarvittavat API-käyttöoikeudet. Avainta ei säilytetä palautettavassa muodossa.

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