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