בניית הורדות עם Insto

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

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

Insto מציג שלוש נקודות מעשיות לגבי אבטחת Credential. ראשית באחסון סודות בצד השרת. לאחר מכן סקירת ההורדה מכסה היעדר הטמעה בחבילת הלקוח. הנקודה הסופית שלו היא היעדר יומנים או מאגרים ציבוריים.

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

Insto מציג שלוש נקודות מעשיות עבור Format identifier. ראשית מופיע הערך המוחזר ללא שינוי. לאחר מכן הסקירה של ההורדה מכסה זמינות לפי קישור. הנקודה האחרונה שלו היא שאין תווית איכות משוערת.

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

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

ב-Insto, ההמתנה הראשונית של שנייה אחת באה קודם כשמסבירים את Job polling. סקירת ההורדה הזו באה אחר כך עם backoff מוגבל ומסתיימת במסירה זמנית חתומה.

{
  "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 שהוגשה ללא צורך.

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