بناء التنزيلات مع 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"}'

التخزين السري لجانب الخادم هو نقطة البداية لسلامة Credential على 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"

بالنسبة لاستطلاع Job ، يتحقق 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. تغطي الرؤية التالية المصادقة المخصصة. تحتفظ الصفحة بأشكال الطلب الموثقة مرئية.