https://easyt.ioبناء التنزيلات مع EasyT
هذا المرجع EasyT هو دليل تنفيذ بدلاً من نقطة نهاية مجهولة نشطة.لا يبدأ الوصول إلى الإنتاج إلا بعد موافقة الدعم على العميل وتخصيص الحدود.
البداية السريعة
يبدأ مضيف API مع وثائق الاعتماد المنشطة بالدعم على EasyT. ثم يقدم هذا الفحص الموجه نقطة نهاية مستأجرة مخصصة. الحقيقة النهائية هي مسار استدعاء الخادم فقط.
X-API-Key: pending_activation_…EasytWorkspacev1# 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. يتبع ذلك التحقق الموجه مع عدم تضمين حزمة العميل ويغلق على عدم وجود سجلات أو مستودعات عامة.
حل رابط
تبدأ عملية حل مع اكتشاف المصدر على 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 ، تأتي القيمة المعادة دون تغيير أولاً عند شرح معرف الشكل. يتبع ذلك التحقق الموجه مع توفر لكل رابط ويغلق على لا تخمين علامة الجودة.
إنشاء ومتابعة عمل التنزيل
الإعداد غير المتزامن هو نقطة البداية لإنشاء الوظيفة على 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"}'workspace_job.GET /v1/jobs/{workspace_job} بنفس المفتاح.| ألف - الحالة | المعنى | إجراءات العملاء |
|---|---|---|
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 بانتظار أولي لمدة ثانية واحدة. يقوم فحصه الموجه بمضاهاة ذلك مع الارتداد المقفل وينتهي بتسليم موقّع مؤقت.
الأخطاء المتوقعة
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 | الطابور / السعة أو أعلى المسار غير متاح مؤقتًا. | حاول مرة أخرى مع التراجع الأسي والتذبذب. |
عقد التشغيل
يختار EasyT بدل تشغيل أثناء المراجعة ، ويوازن بين احتياجات التطبيق وصحة المزود.
- استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
- تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
- استخدام الارتداد الأسي المحدود مع التشتت لـ
429,503والأخطاء القابلة لإعادة المحاولة. - لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
- احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.
يبدأ الوصول إلى المخطط مع التنشيط قبل الاستكشاف على EasyT. هذا التحقق الموجه ثم يقدم المصادقة المخصصة. الحقيقة النهائية هي أشكال طلب موثقة.
تنشيط من خلال الدعم
تضمن الغرض من العميل وعبء العمل الشهري المتوقع والشبكات المطلوبة في مذكرة التنشيط.يمكن EasyT بعد ذلك اختيار حل ونطاقات العمل بشكل صحيح قبل إنتاج سر واحد للمنظر.
طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.