Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med DWYT

Kodexemplen DWYT dokumenterar den framtida begärningssekvensen. Produktionsanrop förblir stängda tills videoklienten har granskats och operatörstilldelade autentiseringsuppgifter har aktiverats.

DwytFlowJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

DWYT:s formatkarta granskar aktiverade referenser för API-värden. Den visar en tilldelad klientslutpunkt härnäst och döljer inte en anropsväg endast för servern.

Webbadress till klienthttps://dwyt.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilDwytFlow

API-versionv1

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

För säkerhet för autentiseringsuppgifter börjar DWYT med serverbaserad hemlig lagring. Dess formatkarta parar det med ingen inbäddning i klientpaket och avslutas med inga offentliga loggar eller kodförråd.

Lösa en länk

DWYT:s formatkarta granskar källidentifiering för Resolve-operationen. Den visar format från en inskickad URL nästa och döljer inte några påhittade utdata.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`public_media`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

För formatidentifieraren börjar DWYT med det returnerade värdet oförändrat. Dess formatkarta parar ihop det med tillgänglighet per länk och avslutas utan någon gissad kvalitetsetikett.

Skapa och följ ett nedladdningsjobb

För jobbkörning kontrollerar DWYT asynkron förberedelse före en kort HTTP-begäran. Denna formatkarta gör också den avgränsade exekveringen av arbetare tydlig.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`public_media`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`rendition_key`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara flow_id.

2OmröstningsstatusGET /v1/jobs/{flow_id} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

curl https://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

Jobbavfrågning börjar med en initial väntan på en sekund på DWYT. Denna formatkarta presenterar sedan begränsad backoff. Det sista faktumet är tillfällig signerad leverans.

Förutsägbara fel

DWYT hanterar felkontrakt genom att först identifiera ett icke-2xx-kuvert. Det följs av ett supportärende-ID och har förutsägbar klienthantering i åtanke.

{
  "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	Typisk betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

DWYT granskar integreringen innan han väljer kvoter som skyddar både videoklienten och uppströms tjänster.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

DWYT:s formatkarta granskar aktivering före utforskning för åtkomst till Schema. Den visar tilldelad autentisering därefter och döljer inte dokumenterade förfrågningsformat.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Förklara tillämpningen bakom begäran, dess uppskattade månatliga trafik och de videotjänster den kommer att använda. DWYT granskar dessa uppgifter, tilldelar nödvändiga API-behörigheter och behåller inget återställningsbart nyckelvärde.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.