https://insts.ioBuild downloads with Insts
The Insts workbench below is documentation for a prospective client. Operator review comes before any executable credential or call allowance is created.
البداية السريعة
API host starts with support-activated credentials on Insts. The next view covers an assigned tenant endpoint. The page keeps a server-only call path visible.
X-API-Key: pending_activation_…InstsConnectv1# 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"}'Server-side secret storage is the starting point for Credential safety on Insts. An inspection bench then presents no client bundle embedding and explains no public logs or repositories.
حل رابط
Resolve operation starts with source detection on Insts. The next view covers formats from one submitted URL. The page keeps no invented outputs visible.
/v1/resolveالنطاق: حل| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
shared_post | عنوان URL HTTPS | نعم | صفحة وسائل الإعلام العامة أو المأذون بها لتحليل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}The returned value unchanged is the starting point for Format identifier on Insts. An inspection bench then presents per-link availability and explains no guessed quality label.
إنشاء ومتابعة عمل التنزيل
Insts makes Job creation easy to scan. The page starts with asynchronous preparation, moves to a short HTTP request, and clearly states bounded worker execution.
/v1/jobsالنطاق: الوظائف| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
shared_post | عنوان URL HTTPS | نعم | نفس المصدر المُطّبيع المقدم لحلّ. |
asset_option | سلسلة | نعم | معرف دقيق من استجابة الحل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
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"}'connect_job.GET /v1/jobs/{connect_job} with the same key.| ألف - الحالة | المعنى | إجراءات العملاء |
|---|---|---|
queued | تم القبول في الطابور المحدود. | استطلاع رأي مرة أخرى مع التراجع. |
extracting | تحديث البيانات الوصفية المصدر أو الطريق. | واصلوا التصويت. |
processing | التنزيل أو إعادة المزج أو الدمج. | عرض تقدم الخادم. |
ready | تحميل موقع متاح. | أرسل عنوان URL إلى المستخدم. |
failed | خطأ مهيكلة المحطة الطرفية. | Read error_code. Retry only when advised. |
expired | أزيل الناتج المؤقت. | إنشاء وظيفة جديدة. |
curl https://insts.io/v1/jobs/CONNECT_JOB \
-H "X-API-Key: $INSTS_CONNECT_SECRET"For Job polling, Insts checks one-second initial wait before capped backoff. This inspection bench also makes temporary signed delivery clear.
الأخطاء المتوقعة
Error contract begins with one non-2xx envelope on Insts. This inspection bench then presents a support request ID. The final fact is predictable client handling.
{
"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": "…"
}| بروتوكول نقل الملفات السريع | المعنى النموذجي | الإجراء |
|---|---|---|
| 400 | عنوان URL غير صحيح أو جسم أو تنسيق غير متاح. | تصحيح الطلب.حل مرة أخرى للأشكال. |
| 401 | مفتاح مفقود أو غير صالح أو منتهية الصلاحية أو ذات نطاق خاطئ. | تحقق من وثائق الاعتماد على جانب الخادم. |
| 403 | رفضت سياسة المستأجر أو المصدر الطلب. | لا تتجاوز السياسة اتصل بالدعم. |
| 404 | وظيفة غير معروفة أو منتهية الصلاحية. | قم بإنشاء وظيفة جديدة إذا كان ذلك مناسبًا. |
| 429 | طلب أو حد الوظائف النشطة تم الوصول إليه. | Honor retry_after_seconds. |
| 503 | الطابور / السعة أو أعلى المسار غير متاح مؤقتًا. | حاول مرة أخرى مع التراجع الأسي والتذبذب. |
عقد التشغيل
Insts establishes rate boundaries at review time to protect the inspection workspace and every provider route.
- استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
- تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
- Use bounded exponential backoff with jitter for
429,503and retryable errors. - لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
- احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.
Schema access starts with activation before exploration on Insts. The next view covers assigned authentication. The page keeps documented request shapes visible.
Activate through support
Share the workbench use case, estimated call count and services under inspection. Insts reviews that boundary before a tenant credential is displayed once and reduced to a stored hash.
Request activation المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.