فقط پیش نمایش — فعال سازی لازم است

ساخت دانلود ها با EasyT

این EasyT مرجع یک راهنمای پیاده سازی است به جای یک نقطه پایانی فعال ناشناس.دسترسی تولید فقط پس از تأیید پشتیبانی مشتری و اختصاص دادن محدودیت ها آغاز می شود.

EasytWorkspaceJSON در HTTPSکارهای غیر همزمانمدارک اعتباری محدوده‌دار
01

شروع سریع

میزبان API با مدارک شناسایی فعال شده توسط پشتیبانی در EasyT آغاز می شود. این بررسی هدایت شده سپس یک نقطه پایانی مستاجر اختصاص داده شده را ارائه می دهد. حقیقت نهایی یک مسیر تماس فقط سرور است.

نشانی وب مستاجر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نشانی وب HTTPSبلهصفحه رسانه های عمومی یا مجاز برای تجزیه و تحلیل.
tenantرشتهنهدامنه مستاجر اختصاص داده شده.معمولا حذف می شود.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

در EasyT، مقدار بازگردانده شده بدون تغییر ابتدا هنگام توضیح شناسه فرمت می‌آید. این بررسی راهنمایی شده با در دسترس بودن هر لینک دنبال می‌شود و با عدم وجود برچسب کیفیت حدس زده شده پایان می‌یابد.

03

ایجاد و پیگیری یک کار دانلود

آمادگی غیرهمزمان نقطه شروع ایجاد Job در EasyT است. سپس یک چک راهنمایی شده یک درخواست HTTP کوتاه را ارائه می دهد و اجرای کارگر محدود را توضیح می دهد.

پست/v1/jobsحوزه: مشاغل
فیلدنوعلازم استشرح
input_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آمادهآدرس دانلود امضا شده را باز کنید.
وضعیتمعنیعمل مشتری
queuedپذیرفته شده در صف محدود شدهدوباره با عقب نشینی نظرسنجی کنید.
extractingبازسازی متادیتا یا مسیر منبعبه نظر سنجی ادامه دهید.
processingدانلود کردن، ریماکس کردن یا ادغام کردننمایش پیشرفت سرور
readyدانلود امضا شده در دسترس است.آدرس را برای کاربر ارسال کنید.
failedخطای ساختاری ترمینالخوانده شده error_code.فقط در صورت توصیه دوباره سعی کنید
expiredخروجی موقت حذف شد.ایجاد یک شغل جدید
curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

برای Job polling، EasyT با یک ثانیه انتظار اولیه شروع می شود.بررسی هدایت شده آن جفت می شود که با capped backoff و با تحویل موقتی امضا شده به پایان می رسد.

04

خطاهای قابل پیش بینی

EasyT قرارداد Error را برای اسکن آسان می کند.صفحه با یک پاکت غیر 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": "…"
}
انتقال ابرمتنمعنی معمولکنش
400URL نامعتبر، بدنه یا فرمت در دسترس نیست.درخواست را اصلاح کنید.برای فرمت ها دوباره حل کنید.
401کلید گمشده، نامعتبر، منقضی شده یا با دامنه اشتباه.اعتبار جانبی سرور را بررسی کنید.
403مستاجر یا منبع سیاست درخواست را رد کرد.از سیاست دور نشوید با پشتیبانی تماس بگیرید
404شغل نامعلوم یا منقضی شدهدر صورت لزوم یک شغل جدید ایجاد کنید.
429درخواست یا حد فعال-کار رسیده است.افتخار retry_after_seconds.
503صف / ظرفیت یا بالادست به طور موقت در دسترس نیست.دوباره با عقب نشینی نمایی و جیتر سعی کنید.
05

قرارداد عملیاتی

EasyT در طول بررسی، مجوز عملیاتی را انتخاب می کند، نیازهای برنامه را با سلامت ارائه دهنده متعادل می کند.

دسترسی به طرحواره با فعال سازی قبل از کاوش در EasyT آغاز می شود. این چک هدایت شده سپس احراز هویت اختصاص داده شده را ارائه می دهد. حقیقت نهایی اشکال درخواست مستند است.

دسترسی بازبینی شده توسط اپراتور

فعال سازی از طریق پشتیبانی

هدف مشتری، حجم کاری ماهانه مورد انتظار و شبکه‌های درخواست شده را در یادداشت فعال‌سازی وارد کنید. سپس EasyT می‌تواند دامنه حل مسئله و وظایف را به درستی انتخاب کند قبل از تولید یک راز یک‌نمایه.

درخواست فعال سازی کلیدها محدوده مستاجر، قابل لغو و از طریق فرم تماس صادر می شوند.اسکریپت های ناشناس نمی توانند کار دانلودر را اجرا کنند.