Build downloads with DWYT

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

For Credential safety, DWYT begins with server-side secret storage. Its format map pairs that with no client bundle embedding and ends with no public logs or repositories.

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

For Format identifier, DWYT begins with the returned value unchanged. Its format map pairs that with per-link availability and ends with no guessed quality label.

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

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

Job polling begins with one-second initial wait on DWYT. This format map then presents capped backoff. The final fact is temporary signed delivery.

{
  "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": "…"
}

• idempotent アプリケーションロジックを使用し、同じユーザークリックに対して重複ジョブを開始しないでください。
• キャッシュはメタデータを簡単に解決しますが、署名されたダウンロード URL は常に有効期限切れとみなします。
• Use bounded exponential backoff with jitter for 429, 503 and retryable errors.
• パブリックメディアまたはアクセス権限があるメディアのみを処理します。DRMやアクセス制御はバイパスされません。
• リクエスト ID とジョブ ID をプライベートの操作ログに保持します。送信された URL を不必要にログに記録しないでください。

DWYT's format map reviews activation before exploration for Schema access. It shows assigned authentication next and does not obscure documented request shapes.