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

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

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

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

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

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

curl -X POST https://insts.io/v1/jobs \
  -H "X-API-Key: $INSTS_CONNECT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID","asset_option":"18"}'

curl https://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

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

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

גישה לסכמה מתחילה בהפעלה לפני חקירה ב-Insts. התצוגה הבאה מכסה אימות שהוקצה. הדף שומר על צורות הבקשה המתועדות גלויות.