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, אחסון סודות בצד השרת קודם כאשר מסבירים את בטיחות האישורים. בדיקת ההכוונה הזו נמשכת ללא הטמעה בחבילת הלקוח ומסתיימת ללא יומני ציבור או מאגרים.
פתור קישור
פעולה פתרון מתחילה עם גילוי מקור על 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 קצרה ומוסברת הרצה מוגבלת של worker.
/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 | הורדה חתומה זמינה. | שלח את כתובת ה- 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": "…"
}| HTTP | משמעות טיפוסית | פעולה |
|---|---|---|
| 400 | כתובת URL לא חוקית, גוף או פורמט לא זמין. | תקן את הבקשה. נסה שוב עבור פורמטים. |
| 401 | מפתח חסר, לא חוקי, שפג תוקפו או עם תחום שגוי. | בדוק את האישורים בצד השרת. |
| 403 | מדיניות השוכר או המקור דחתה את הבקשה. | אל לעקוף את המדיניות. פנה לתמיכה. |
| 404 | עבודה לא ידועה או שפג תוקפה. | צור משימה חדשה אם מתאים. |
| 429 | הגעת למגבלת בקשות או עבודות פעילות. | כבוד. retry_after_seconds. |
| 503 | תור/קיבולת או זרם עליון זמינים זמנית. | נסה שוב עם השהייה מעריכית וסטייה אקראית. |
חוזה תפעולי
EasyT בוחר הקצאת הפעלה במהלך הסקירה, מאזנת בין צורכי היישום לבריאות הספק.
- השתמש בהיגיון יישום idempotent ולעולם לא להתחיל משרות כפולות עבור אותו משתמש לחץ.
- מטמון מטא-נתוני פתרון לזמן קצר, אך תמיד התייחס לכתובות URL של הורדה חתומות ככאלה שפגות תוקף.
- השתמש בהשהיית חזרה מעריכית מוגבלת עם רעש אקראי
429,503ושגיאות הניתנות לניסיון חוזר. - עיבוד רק מדיה ציבורית או מדיה שאתה מוסמך לגשת אליה. DRM ובקרת גישה לא עוקפים.
- שמרו על מזהים של בקשות ומזהים של משרות ביומני תפעול פרטיים. אל תרשמו את כתובת ה- URL שהוגשה ללא צורך.
גישה לסכמה מתחילה בהפעלה לפני חקר על EasyT. בדיקה מודרכת זו מציגה לאחר מכן אימות מוקצה. העובדה הסופית היא צורות בקשה מתועדות.
הפעל באמצעות תמיכה
כלול/י את מטרת הלקוח, עומס העבודה החודשי הצפוי והרשתות המבוקשות בהערת ההפעלה. לאחר מכן EasyT יכול לבחור נכונה את תחומי ה-resolve וה-job לפני הפקת סוד בתצוגה אחת.
בקש הפעלה מפתחות הם בעלי תחום דייר, ניתנים לביטול ונמסרים באמצעות טופס יצירת קשר. תסריטים אנונימיים אינם יכולים לבצע עבודה של הורדה.