בניית הורדות עם 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"}'

למען אבטחת האישורים, DWYT מתחיל באחסון סודות בצד השרת. מפת הפורמט שלו מצמידה זאת ללא הטמעה בחבילת הלקוח ומסתיימת ללא יומנים או מאגרים ציבוריים.

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

עבור מזהה הפורמט, DWYT מתחיל בערך המוחזר ללא שינוי. מיפוי הפורמט שלו משייך זאת לזמינות לכל קישור ומסתיים ללא תווית איכות משוערת.

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"

ההמתנה להתחלת משימת הסקר מתחילה בהמתנה של שנייה אחת ב-DWYT. מפת הפורמטים מציגה אז התמתנות מוגבלת. העובדה הסופית היא משלוח חתום זמני.

{
  "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 של הורדה חתומות ככאלה שפגות תוקף.
• השתמש בהשהיית חזרה מעריכית מוגבלת עם רעש אקראי 429, 503 ושגיאות הניתנות לניסיון חוזר.
• עיבוד רק מדיה ציבורית או מדיה שאתה מוסמך לגשת אליה. DRM ובקרת גישה לא עוקפים.
• שמרו על מזהים של בקשות ומזהים של משרות ביומני תפעול פרטיים. אל תרשמו את כתובת ה- URL שהוגשה ללא צורך.

מפת הפורמטים של DWYT בודקת הפעלה לפני החקירה עבור גישת Schema. היא מציגה את האימות שהוקצה בהמשך ואינה מסתירה את צורות הבקשה המתועדות.