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

בנה הורדות עם downf.io

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

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

התחלה מהירה

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

כתובת דיירhttps://downf.io
אימותX-API-Key: pending_activation_…
פרופיל לקוחDownfBridge
גרסת APIv1
# Available only after support activation
export DOWNF_ACCESS_TOKEN="issued-after-review"

curl -X POST https://downf.io/v1/resolve \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID"}'

אבטחת אישורים מתחילה באחסון סודות בצד השרת ב-DownF. תצוגת התאימות הזו אינה מציגה הטמעת חבילת לקוח. העובדה האחרונה היא שאין יומני רישום או מאגרים ציבוריים.

02

פתור קישור

DownF מארגן את פעולת Resolve סביב זיהוי המקור. תצוגת התאימות שלו משווה פורמטים מכתובת URL אחת שנשלחה. אין פלטים מומצאים נשארת הבדיקה הסופית.

הודעה/v1/resolveטווח: פתרון
שדהסוגנדרשתיאור
media_addressכתובת HTTPSכן.דף מדיה ציבורי או מורשה לניתוח.
tenantמחרוזתלא, לא, לא.דומיין שוכר מוקצה. בדרך כלל מושמט.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

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

03

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

יצירת משימות מתחילה בהכנה אסינכרונית ב-DownF. התצוגה הבאה מכסה בקשת HTTP קצרה. הדף שומר את ביצוע העובדים המוגבל גלוי.

הודעה/v1/jobsתחום: משרות
שדהסוגנדרשתיאור
media_addressכתובת HTTPSכן.אותו מקור מנורמל הוגש לפתרון.
output_refמחרוזתכן.מזהה מדויק מתשובת הפתרון.
tenantמחרוזתלא, לא, לא.דומיין שוכר מוקצה. בדרך כלל מושמט.
curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'
1202 התקבלשמור transfer_ref.
2סטטוס סקרGET /v1/jobs/{transfer_ref} עם אותו מפתח.
3מוכןפתח את כתובת ההורדה החתומה.
סטטוסמשמעותפעולת לקוח
queuedהתקבל לתור המוגבל.סקר שוב עם בקאאוף.
extractingמרענן מטא-נתוני מקור או מסלול.המשך סקר.
processingמוריד, מבצע רימקס או מאחד.הצג התקדמות שרת.
readyהורדה חתומה זמינה.שלח את כתובת ה- URL למשתמש.
failedשגיאה מבנית של המסוף.קרא error_code. לנסות שוב רק כאשר מומלץ.
expiredהפלט הזמני הוסרה.צור עבודה חדשה.
curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

תצוגת התאימות של DownF סוקרת המתנה ראשונית של שנייה אחת עבור polling של Job. היא מציגה את ה-backoff הבא המוגבל ואינה מסתירה מסירה חתומה זמנית.

04

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

DownF מציגה שלוש נקודות מעשיות עבור חוזה שגיאה. ראשית מגיע מעטפת אחת שאינה 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

חוזה תפעולי

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

DownF מארגן את הגישה ל-Schema סביב הפעלה לפני חקירה. תצוגת התאימות שלו משווה אימות שהוקצה. צורות הבקשה המתועדות נשארות הבדיקה הסופית.

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

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

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

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