Preview only — activation required

Build downloads with Insto

Insto presents a visual-media integration blueprint for evaluation. Live analysis and job requests stay unavailable until support grants tenant-scoped authorization.

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

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

For API host, Insto begins with support-activated credentials. Its download review pairs that with an assigned tenant endpoint and ends with a server-only call path.

عنوان URL المستأجرhttps://insto.app
التوثيقX-API-Key: pending_activation_…
نبذة عن العميلInstoMedia
إصدار APIv1
# 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 presents three practical points for Credential safety. First comes server-side secret storage. The download review then covers no client bundle embedding. Its final point is no public logs or repositories.

02

حل رابط

For Resolve operation, Insto begins with source detection. Its download review pairs that with formats from one submitted URL and ends with no invented outputs.

الوظائف/v1/resolveالنطاق: حل
الميداننوع المشروعالمطلوبوصف المشروع
media_sourceعنوان URL HTTPSنعمصفحة وسائل الإعلام العامة أو المأذون بها لتحليل.
tenantسلسلةلانطاق المستأجر المخصص.عادة ما يتم حذفه.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Insto presents three practical points for Format identifier. First comes the returned value unchanged. The download review then covers per-link availability. Its final point is no guessed quality label.

03

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

Insto organizes Job creation around asynchronous preparation. Its download review compares a short HTTP request. Bounded worker execution remains the final check.

الوظائف/v1/jobsالنطاق: الوظائف
الميداننوع المشروعالمطلوبوصف المشروع
media_sourceعنوان URL HTTPSنعمنفس المصدر المُطّبيع المقدم لحلّ.
media_variantسلسلةنعممعرف دقيق من استجابة الحل.
tenantسلسلةلانطاق المستأجر المخصص.عادة ما يتم حذفه.
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"}'
1202 مقبولةSave prepare_id.
2حالة الاستفتاءGET /v1/jobs/{prepare_id} with the same key.
3جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
queuedتم القبول في الطابور المحدود.استطلاع رأي مرة أخرى مع التراجع.
extractingتحديث البيانات الوصفية المصدر أو الطريق.واصلوا التصويت.
processingالتنزيل أو إعادة المزج أو الدمج.عرض تقدم الخادم.
readyتحميل موقع متاح.أرسل عنوان URL إلى المستخدم.
failedخطأ مهيكلة المحطة الطرفية.Read error_code. Retry only when advised.
expiredأزيل الناتج المؤقت.إنشاء وظيفة جديدة.
curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

In Insto, one-second initial wait comes first when explaining Job polling. That download review follows with capped backoff and closes on temporary signed delivery.

04

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

To explain Error contract, Insto separates one non-2xx envelope from a support request ID. A download review gives predictable client handling its own place.

{
  "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

عقد التشغيل

Insto tailors call limits to the visual-media use case and the networks the approved client will contact.

For Schema access, Insto begins with activation before exploration. Its download review pairs that with assigned authentication and ends with documented request shapes.

الوصول الذي يستعرضه المشغل

Activate through support

Outline the visual-media product, anticipated monthly usage and post types you plan to handle. Insto grants only the necessary analysis or preparation scopes and never stores the readable token.

Request activation المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.