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

הורדות בנייה עם QuickDL

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

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

התחלה מהירה

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

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

02

פתור קישור

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

03

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

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

04

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

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

חוזה תפעולי

QuickDL מענק מכסה קומפקטי, ספציפי ללקוח שתומך בשילוב מבלי לפגוע בשירותי מקור.

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

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

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

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

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