بناء التنزيلات مع 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 ، تأتي ثانية واحدة من الانتظار الأولي أولاً عند شرح استطلاع الوظائف. يتبع ذلك تنزيل مراجعة مع سقف الركود ويغلق على التسليم المؤقت الموقع.

{
  "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 مع التنشيط قبل الاستكشاف. استعراض التنزيل الخاص به يزوج ذلك مع المصادقة المخصصة وينتهي بأشكال الطلب الموثقة.