Preview only — activation required

Build 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.

InstsConnectJSON عبر HTTPSوظائف غير متزامنةوثائق التفويض المحددة النطاق
01

البداية السريعة

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.

عنوان URL المستأجرhttps://insts.io
التوثيقX-API-Key: pending_activation_…
نبذة عن العميلInstsConnect
إصدار APIv1
# 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.

02

حل رابط

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.

03

إنشاء ومتابعة عمل التنزيل

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"}'
1202 مقبولةSave connect_job.
2حالة الاستفتاءGET /v1/jobs/{connect_job} with the same key.
3جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
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.

04

الأخطاء المتوقعة

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الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.حاول مرة أخرى مع التراجع الأسي والتذبذب.
05

عقد التشغيل

Insts establishes rate boundaries at review time to protect the inspection workspace and every provider route.

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 المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.