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 | نشانی وب HTTPS | بله | صفحه رسانه های عمومی یا مجاز برای تجزیه و تحلیل. |
tenant | رشته | نه | دامنه مستاجر اختصاص داده شده.معمولا حذف می شود. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}در EasyT، مقدار بازگردانده شده بدون تغییر ابتدا هنگام توضیح شناسه فرمت میآید. این بررسی راهنمایی شده با در دسترس بودن هر لینک دنبال میشود و با عدم وجود برچسب کیفیت حدس زده شده پایان مییابد.
ایجاد و پیگیری یک کار دانلود
آمادگی غیرهمزمان نقطه شروع ایجاد 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"}'workspace_job.GET /v1/jobs/{workspace_job} با همان کلید| وضعیت | معنی | عمل مشتری |
|---|---|---|
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 و با تحویل موقتی امضا شده به پایان می رسد.
خطاهای قابل پیش بینی
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": "…"
}| انتقال ابرمتن | معنی معمول | کنش |
|---|---|---|
| 400 | URL نامعتبر، بدنه یا فرمت در دسترس نیست. | درخواست را اصلاح کنید.برای فرمت ها دوباره حل کنید. |
| 401 | کلید گمشده، نامعتبر، منقضی شده یا با دامنه اشتباه. | اعتبار جانبی سرور را بررسی کنید. |
| 403 | مستاجر یا منبع سیاست درخواست را رد کرد. | از سیاست دور نشوید با پشتیبانی تماس بگیرید |
| 404 | شغل نامعلوم یا منقضی شده | در صورت لزوم یک شغل جدید ایجاد کنید. |
| 429 | درخواست یا حد فعال-کار رسیده است. | افتخار retry_after_seconds. |
| 503 | صف / ظرفیت یا بالادست به طور موقت در دسترس نیست. | دوباره با عقب نشینی نمایی و جیتر سعی کنید. |
قرارداد عملیاتی
EasyT در طول بررسی، مجوز عملیاتی را انتخاب می کند، نیازهای برنامه را با سلامت ارائه دهنده متعادل می کند.
- از منطق برنامه idempotent استفاده کنید و هرگز کارهای تکراری را برای همان کلیک کاربر شروع نکنید.
- حافظه نهان به طور خلاصه فراداده را حل می کند، اما همیشه با URL های دانلود امضا شده به عنوان انقضا رفتار می کند.
- استفاده از پسانداز نمایی محدود شده با جیتر برای
429,503و خطاهای قابل بازنگری - فقط رسانه های عمومی یا رسانه هایی را که مجاز به دسترسی به آنها هستید پردازش کنید. DRM و کنترل های دسترسی دور زده نمی شوند.
- شناسه های درخواست و شناسه های کار را در لاگ های عملیاتی خصوصی نگه دارید. URL های ارسال شده را بدون نیاز به آن لاگ نکنید.
دسترسی به طرحواره با فعال سازی قبل از کاوش در EasyT آغاز می شود. این چک هدایت شده سپس احراز هویت اختصاص داده شده را ارائه می دهد. حقیقت نهایی اشکال درخواست مستند است.
فعال سازی از طریق پشتیبانی
هدف مشتری، حجم کاری ماهانه مورد انتظار و شبکههای درخواست شده را در یادداشت فعالسازی وارد کنید. سپس EasyT میتواند دامنه حل مسئله و وظایف را به درستی انتخاب کند قبل از تولید یک راز یکنمایه.
درخواست فعال سازی کلیدها محدوده مستاجر، قابل لغو و از طریق فرم تماس صادر می شوند.اسکریپت های ناشناس نمی توانند کار دانلودر را اجرا کنند.