https://easyf.appבניית הורדות עם EasyF
EasyF מראה את הממשק מראש כך שמפתחים יכולים להעריך את עבודתם. עדיין נדרשת סקירה של תמיכה לפני שמפתח חי וגבולות שימוש קיימים.
התחלה מהירה
כדי להסביר את מארח ה-API, EasyF מפריד בין אישורים שהופעלו על ידי התמיכה לבין נקודת קצה שהוקצתה לדייר. תהליך עבודה בשפה פשוטה מעניק למסלול קריאה של שרת בלבד מקום משלו.
X-API-Key: pending_activation_…EasyfClientv1# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"
curl -X POST https://easyf.app/v1/resolve \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'בטיחות תעודות זהות מתחילה באחסון סודי בצד השרת על EasyF. התצוגה הבאה מכסה אין הטמעת חבילות לקוח. הדף שומר על שום יומנים ציבוריים או מאגרי נראה לעין.
פתור קישור
כדי להסביר את פעולת Resolve, EasyF מפריד בין זיהוי המקור לבין הפורמטים מתוך כתובת URL אחת שנשלחה. תהליך עבודה בשפה פשוטה אינו נותן לפלטים מומצאים מקום משלהם.
/v1/resolveטווח: פתרון| שדה | סוג | נדרש | תיאור |
|---|---|---|---|
asset_url | כתובת HTTPS | כן. | דף מדיה ציבורי או מורשה לניתוח. |
tenant | מחרוזת | לא, לא, לא. | דומיין שוכר מוקצה. בדרך כלל מושמט. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}מזהה הפורמט מתחיל בערך המוחזר ללא שינוי ב-EasyF. התצוגה הבאה מכסה זמינות לכל קישור. הדף אינו מציג שום תווית איכות משוערת.
צור ועקוב אחר משימת הורדה
EasyF מציג שלוש נקודות מעשיות ליצירת משימה. ראשית באה הכנה אסינכרונית. לאחר מכן, תהליך העבודה בשפה פשוטה מכסה בקשת HTTP קצרה. הנקודה הסופית שלו היא ביצוע מוגבל של העובד.
/v1/jobsתחום: משרות| שדה | סוג | נדרש | תיאור |
|---|---|---|---|
asset_url | כתובת HTTPS | כן. | אותו מקור מנורמל הוגש לפתרון. |
variant_code | מחרוזת | כן. | מזהה מדויק מתשובת הפתרון. |
tenant | מחרוזת | לא, לא, לא. | דומיין שוכר מוקצה. בדרך כלל מושמט. |
curl -X POST https://easyf.app/v1/jobs \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'delivery_id.GET /v1/jobs/{delivery_id} עם אותו מפתח.| סטטוס | משמעות | פעולת לקוח |
|---|---|---|
queued | התקבל לתור המוגבל. | סקר שוב עם בקאאוף. |
extracting | מרענן מטא-נתוני מקור או מסלול. | המשך סקר. |
processing | מוריד, מבצע רימקס או מאחד. | הצג התקדמות שרת. |
ready | הורדה חתומה זמינה. | שלח את כתובת ה- URL למשתמש. |
failed | שגיאה מבנית של המסוף. | קרא error_code. לנסות שוב רק כאשר מומלץ. |
expired | הפלט הזמני הוסרה. | צור עבודה חדשה. |
curl https://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF ניגש לסקרי משימות באמצעות המתנה ראשונית של שנייה אחת, ולאחר מכן גיבוי מוגבל. תהליך העבודה בשפה פשוטה שומר על מסירת הקבצים הזמניים החתומים מפורשת.
שגיאות צפויות
EasyF מארגן חוזה שגיאה סביב מעטפה אחת שאינה 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 | תור/קיבולת או זרם עליון זמינים זמנית. | נסה שוב עם השהייה מעריכית וסטייה אקראית. |
חוזה תפעולי
EasyF מסכים לגבולות שימוש מעשיים עם כל מוצר מאושר כדי לשמר זרימת עבודה מודרכת צפויה.
- השתמש בהיגיון יישום idempotent ולעולם לא להתחיל משרות כפולות עבור אותו משתמש לחץ.
- מטמון מטא-נתוני פתרון לזמן קצר, אך תמיד התייחס לכתובות URL של הורדה חתומות ככאלה שפגות תוקף.
- השתמש בהשהיית חזרה מעריכית מוגבלת עם רעש אקראי
429,503ושגיאות הניתנות לניסיון חוזר. - עיבוד רק מדיה ציבורית או מדיה שאתה מוסמך לגשת אליה. DRM ובקרת גישה לא עוקפים.
- שמרו על מזהים של בקשות ומזהים של משרות ביומני תפעול פרטיים. אל תרשמו את כתובת ה- URL שהוגשה ללא צורך.
כדי להסביר את הגישה ל‑Schema, EasyF מפריד בין הפעלה לפני חקירה לבין אימות מוקצה. זרימת עבודה בשפה פשוטה מעניקה למבני הבקשה המתועדים מקום משלהם.
הפעל באמצעות תמיכה
ספרו ל-EasyF מה אתם בונים, באיזו תדירות הוא יקרא ל-API ואילו ספקים חשובים. הסקירה קובעת אילו פעולות מותרות, ואז חושפת אישור גישה פעם אחת בלבד תוך שמירת התקציר המאובטח שלו.
בקש הפעלה מפתחות הם בעלי תחום דייר, ניתנים לביטול ונמסרים באמצעות טופס יצירת קשר. תסריטים אנונימיים אינם יכולים לבצע עבודה של הורדה.