https://downf.ioבנה הורדות עם downf.io
DownF שומרת על ביצוע ה-API מושבת עד שמפעיל בוחן את מקרה השימוש התואם. הדוגמאות מתארות את החוזה המתוכנן, בעוד שאישורי גישה אמיתיים ומכסות מגיעים רק באמצעות הפעלה על ידי התמיכה.
התחלה מהירה
DownF מארגן את מארח ה-API סביב אישורים שהופעלו באמצעות תמיכה. תצוגת התאימות שלו משווה נקודת קצה שהוקצתה לדייר. נתיב קריאה לשרת בלבד נשאר הבדיקה הסופית.
X-API-Key: pending_activation_…DownfBridgev1# 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. תצוגת התאימות הזו אינה מציגה הטמעת חבילת לקוח. העובדה האחרונה היא שאין יומני רישום או מאגרים ציבוריים.
פתור קישור
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. תצוגת תאימות זו מציגה לאחר מכן את הזמינות לכל קישור. העובדה הסופית היא שאין תווית איכות משוערת.
צור ועקוב אחר משימת הורדה
יצירת משימות מתחילה בהכנה אסינכרונית ב-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"}'transfer_ref.GET /v1/jobs/{transfer_ref} עם אותו מפתח.| סטטוס | משמעות | פעולת לקוח |
|---|---|---|
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 הבא המוגבל ואינה מסתירה מסירה חתומה זמנית.
שגיאות צפויות
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 | תור/קיבולת או זרם עליון זמינים זמנית. | נסה שוב עם השהייה מעריכית וסטייה אקראית. |
חוזה תפעולי
DownF מקצה תקרת בקשה לאחר סקירה של הלקוח המיועד, שמירה על בדיקות התאימות שלו וספקים במעלה הזרם יציבים.
- השתמש בהיגיון יישום idempotent ולעולם לא להתחיל משרות כפולות עבור אותו משתמש לחץ.
- מטמון מטא-נתוני פתרון לזמן קצר, אך תמיד התייחס לכתובות URL של הורדה חתומות ככאלה שפגות תוקף.
- השתמש בהשהיית חזרה מעריכית מוגבלת עם רעש אקראי
429,503ושגיאות הניתנות לניסיון חוזר. - עיבוד רק מדיה ציבורית או מדיה שאתה מוסמך לגשת אליה. DRM ובקרת גישה לא עוקפים.
- שמרו על מזהים של בקשות ומזהים של משרות ביומני תפעול פרטיים. אל תרשמו את כתובת ה- URL שהוגשה ללא צורך.
DownF מארגן את הגישה ל-Schema סביב הפעלה לפני חקירה. תצוגת התאימות שלו משווה אימות שהוקצה. צורות הבקשה המתועדות נשארות הבדיקה הסופית.
הפעל באמצעות תמיכה
תאר את המוצר, חזה את מספר השיחות החודשי שלו ופרט את הפלטפורמות שעליו לנתח. תמיכת DownF תאשר את ההיקפים הנדרשים לפני הנפקת אישור חד-פעמי גלוי, שהעותק השמור שלו הוא גיבוב בלבד.
בקש הפעלה מפתחות הם בעלי תחום דייר, ניתנים לביטול ונמסרים באמצעות טופס יצירת קשר. תסריטים אנונימיים אינם יכולים לבצע עבודה של הורדה.