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