תצוגה מקדימה בלבד — נדרשת הפעלה

בניית הורדות עם EasyF

EasyF מראה את הממשק מראש כך שמפתחים יכולים להעריך את עבודתם. עדיין נדרשת סקירה של תמיכה לפני שמפתח חי וגבולות שימוש קיימים.

EasyfClientJSON מעל HTTPSעבודות אסינכרוניותאישורים ממוקדים
01

התחלה מהירה

כדי להסביר את מארח ה-API, EasyF מפריד בין אישורים שהופעלו על ידי התמיכה לבין נקודת קצה שהוקצתה לדייר. תהליך עבודה בשפה פשוטה מעניק למסלול קריאה של שרת בלבד מקום משלו.

כתובת דיירhttps://easyf.app
אימותX-API-Key: pending_activation_…
פרופיל לקוחEasyfClient
גרסת APIv1
# 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. התצוגה הבאה מכסה אין הטמעת חבילות לקוח. הדף שומר על שום יומנים ציבוריים או מאגרי נראה לעין.

02

פתור קישור

כדי להסביר את פעולת 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. התצוגה הבאה מכסה זמינות לכל קישור. הדף אינו מציג שום תווית איכות משוערת.

03

צור ועקוב אחר משימת הורדה

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"}'
1202 התקבלשמור delivery_id.
2סטטוס סקרGET /v1/jobs/{delivery_id} עם אותו מפתח.
3מוכןפתח את כתובת ההורדה החתומה.
סטטוסמשמעותפעולת לקוח
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 ניגש לסקרי משימות באמצעות המתנה ראשונית של שנייה אחת, ולאחר מכן גיבוי מוגבל. תהליך העבודה בשפה פשוטה שומר על מסירת הקבצים הזמניים החתומים מפורשת.

04

שגיאות צפויות

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תור/קיבולת או זרם עליון זמינים זמנית.נסה שוב עם השהייה מעריכית וסטייה אקראית.
05

חוזה תפעולי

EasyF מסכים לגבולות שימוש מעשיים עם כל מוצר מאושר כדי לשמר זרימת עבודה מודרכת צפויה.

כדי להסביר את הגישה ל‑Schema, EasyF מפריד בין הפעלה לפני חקירה לבין אימות מוקצה. זרימת עבודה בשפה פשוטה מעניקה למבני הבקשה המתועדים מקום משלהם.

גישה מבוקרה על ידי המפעיל

הפעל באמצעות תמיכה

ספרו ל-EasyF מה אתם בונים, באיזו תדירות הוא יקרא ל-API ואילו ספקים חשובים. הסקירה קובעת אילו פעולות מותרות, ואז חושפת אישור גישה פעם אחת בלבד תוך שמירת התקציר המאובטח שלו.

בקש הפעלה מפתחות הם בעלי תחום דייר, ניתנים לביטול ונמסרים באמצעות טופס יצירת קשר. תסריטים אנונימיים אינם יכולים לבצע עבודה של הורדה.