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