عرض مسبق فقط — يلزم التفعيل

بناء التنزيلات مع EasyT

هذا المرجع EasyT هو دليل تنفيذ بدلاً من نقطة نهاية مجهولة نشطة.لا يبدأ الوصول إلى الإنتاج إلا بعد موافقة الدعم على العميل وتخصيص الحدود.

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

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

يبدأ مضيف API مع وثائق الاعتماد المنشطة بالدعم على EasyT. ثم يقدم هذا الفحص الموجه نقطة نهاية مستأجرة مخصصة. الحقيقة النهائية هي مسار استدعاء الخادم فقط.

عنوان URL المستأجرhttps://easyt.io
التوثيقX-API-Key: pending_activation_…
نبذة عن العميلEasytWorkspace
إصدار APIv1
# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"

curl -X POST https://easyt.io/v1/resolve \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

في EasyT ، يأتي التخزين السري لجانب الخادم أولاً عند شرح سلامة Credential. يتبع ذلك التحقق الموجه مع عدم تضمين حزمة العميل ويغلق على عدم وجود سجلات أو مستودعات عامة.

02

حل رابط

تبدأ عملية حل مع اكتشاف المصدر على EasyT. هذا التحقق الموجه ثم يقدم تنسيقات من عنوان URL واحد مقدم. الحقيقة النهائية هي عدم وجود مخرجات مخترعة.

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

في EasyT ، تأتي القيمة المعادة دون تغيير أولاً عند شرح معرف الشكل. يتبع ذلك التحقق الموجه مع توفر لكل رابط ويغلق على لا تخمين علامة الجودة.

03

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

الإعداد غير المتزامن هو نقطة البداية لإنشاء الوظيفة على EasyT. ثم يقدم فحص موجه طلب HTTP قصير ويوضح تنفيذ العامل المحدود.

الوظائف/v1/jobsالنطاق: الوظائف
الميداننوع المشروعالمطلوبوصف المشروع
input_urlعنوان URL HTTPSنعمنفس المصدر المُطّبيع المقدم لحلّ.
stream_choiceسلسلةنعممعرف دقيق من استجابة الحل.
tenantسلسلةلانطاق المستأجر المخصص.عادة ما يتم حذفه.
curl -X POST https://easyt.io/v1/jobs \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'
1202 مقبولةحفظ workspace_job.
2حالة الاستفتاءGET /v1/jobs/{workspace_job} بنفس المفتاح.
3جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
queuedتم القبول في الطابور المحدود.استطلاع رأي مرة أخرى مع التراجع.
extractingتحديث البيانات الوصفية المصدر أو الطريق.واصلوا التصويت.
processingالتنزيل أو إعادة المزج أو الدمج.اعرض تقدم معالجة الخادم.
readyتحميل موقع متاح.أرسل عنوان URL إلى المستخدم.
failedخطأ مهيكلة المحطة الطرفية.قراءة error_code.حاول مرة أخرى فقط عندما ينصح.
expiredأزيل الناتج المؤقت.إنشاء وظيفة جديدة.
curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

بالنسبة لاستطلاع الوظائف ، يبدأ EasyT بانتظار أولي لمدة ثانية واحدة. يقوم فحصه الموجه بمضاهاة ذلك مع الارتداد المقفل وينتهي بتسليم موقّع مؤقت.

04

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

EasyT يجعل عقد الخطأ سهل المسح الضوئي.تبدأ الصفحة مع مظروف واحد غير 2xx، وتنتقل إلى معرف طلب دعم، وتذكر بوضوح معالجة العميل المتوقعة.

{
  "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طلب أو حد الوظائف النشطة تم الوصول إليه.الشرف retry_after_seconds.
503الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.حاول مرة أخرى مع التراجع الأسي والتذبذب.
05

عقد التشغيل

يختار EasyT بدل تشغيل أثناء المراجعة ، ويوازن بين احتياجات التطبيق وصحة المزود.

يبدأ الوصول إلى المخطط مع التنشيط قبل الاستكشاف على EasyT. هذا التحقق الموجه ثم يقدم المصادقة المخصصة. الحقيقة النهائية هي أشكال طلب موثقة.

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

تنشيط من خلال الدعم

تضمن الغرض من العميل وعبء العمل الشهري المتوقع والشبكات المطلوبة في مذكرة التنشيط.يمكن EasyT بعد ذلك اختيار حل ونطاقات العمل بشكل صحيح قبل إنتاج سر واحد للمنظر.

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