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

בנה הורדות עם FFast

FFast חושף את צורת API המיועדת מבלי להפעיל שיחות ציבוריות. מפעיל מפעיל מסמכי אימות ומכסות מדודות לאחר בחינת האינטגרציה המוצעת.

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

התחלה מהירה

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

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

02

פתור קישור

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

03

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

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

04

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

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

חוזה תפעולי

FFast מפעיל מכסות מדודות ששומרות על הנדאפ רגישות מבלי להניח עומס לא בטוח על פלטפורמות במעלה הזרם.

FFast מתקרב לגישה Schema באמצעות הפעלת לפני חקר, ואז מיועד אימות. הסקירה המהירה שומרת צורות בקשה מתועדות מפורשות.

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

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

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

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