Alleen voorbeeld — activering vereist

Bouw downloads met DWYT

De DWYT codevoorbeelden documenteren de toekomstige aanvraagvolgorde. Productieoproepen blijven gesloten totdat de videoclient is beoordeeld en operator-toegewezen credentials zijn ingeschakeld.

DwytFlowVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

De formatmap van DWYT beoordeelt ondersteuningsgeactiveerde referenties voor de API-host. Het toont een toegewezen tenant-eindpunt en verbergt het pad van een server-only oproep niet.

URL van tenanthttps://dwyt.app

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantDwytFlow

API-versiev1

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

Voor credentialveiligheid begint DWYT met server-side geheime opslag. De formatmap koppelt dat aan geen client-bundel embedding en eindigt met geen openbare logs of repositories.

Een koppeling oplossen

De formatmap van DWYT beoordeelt bronherkenning voor de Resolve-operatie. Het toont formaten van één ingediende URL en verbergt geen niet-bestaande uitvoer.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`public_media`	HTTPS-URL	Ja.	Openbare of geautoriseerde mediapagina om te analyseren.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

Voor de formaatidentificatie begint DWYT met de geretourneerde waarde ongewijzigd. De formatmap koppelt dit aan beschikbaarheid per link en eindigt zonder geraden kwaliteitslabel.

Maak en volg een downloadtaak

Voor het aanmaken van taken controleert DWYT of er een asynchrone voorbereiding is voordat een kort HTTP-verzoek wordt verzonden.

POST/v1/jobsScope: vacatures

Veld	Type	Vereist	Beschrijving
`public_media`	HTTPS-URL	Ja.	Dezelfde genormaliseerde bron ingediend om op te lossen.
`rendition_key`	tekenreeks	Ja.	Een exacte ID uit de resolve-respons.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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 GeaccepteerdOpslaan flow_id.

2Poll status 1GET /v1/jobs/{flow_id} met dezelfde sleutel.

3KlaarOpen de ondertekende download-URL.

Status	Betekenis	Actie van de klant
`queued`	Toegestaan in de beperkte wachtrij.	Poll weer met achteruit.
`extracting`	Bronmetadata of route vernieuwen.	Ga door met pollen.
`processing`	Bezig met downloaden, remuxen of samenvoegen.	Toon server voortgang.
`ready`	Ondertekende download is beschikbaar.	Stuur de URL naar de gebruiker.
`failed`	Terminal gestructureerde fout.	Lees `error_code`Probeer het alleen opnieuw als dat wordt geadviseerd.
`expired`	Tijdelijke uitvoer werd verwijderd.	Maak een nieuwe taak aan.

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

Taakpolling begint met een initiële wachttijd van één seconde op DWYT. Deze formaatkaart presenteert vervolgens begrensde terugval. Het laatste feit is tijdelijke ondertekende levering.

Voorspelbare fouten

DWYT behandelt de foutcontract door eerst een niet-2xx envelop te identificeren. Daarna volgt een ondersteuningsverzoek-ID en wordt voorspelbare clientafhandeling in het oog gehouden.

{
  "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	Typische betekenis	Actie
400	Ongeldige URL, body of niet beschikbare indeling.	Corrigeer de aanvraag. Los opnieuw op voor formaten.
401	Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.	Controleer de serverzijde referentie.
403	Tenant of bronbeleid heeft de aanvraag afgewezen.	Omzeil het beleid niet. Neem contact op met de ondersteuning.
404	Onbekende of verlopen vacature.	Maak indien nodig een nieuwe taak aan.
429	Aanvraag- of actieve-taaklimiet bereikt.	Eer `retry_after_seconds`.
503	Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.	Probeer het opnieuw met exponentiële backoff en jitter.

Operationeel contract

DWYT controleert de integratie voordat quota's worden gekozen die zowel de videoclient als de upstream-services beschermen.

Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
Gebruik begrensde exponentiële backoff met jitter voor 429, 503 en herprobeerbare fouten.
Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.

De formatmap van DWYT beoordeelt activatie vóór verkenning voor Schema-toegang. Het toont de toegewezen authenticatie als volgende en verbergt de gedocumenteerde aanvraagvormen niet.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Leg de toepassing achter het verzoek uit, de geschatte maandelijkse verkeersvolume en de videoservices die het zal gebruiken. DWYT beoordeelt die details, wijst de benodigde API-machtigingen toe en bewaart geen herstelbare sleutelwaarde.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.