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 ينظم Credential safety حول التخزين السري لجانب الخادم. نظرته الجاهزة للجهاز تقارن لا دمج حزمة العميل. لا توجد سجلات عامة أو مستودعات تبقى الفحص النهائي.
حل رابط
لعملية Resolve ، يتحقق QuickT من اكتشاف المصدر قبل التنسيقات من عنوان URL واحد مقدم. هذا العرض الجاهز للجهاز يجعل أيضًا عدم وجود مخرجات مخترعة واضحة.
/v1/resolveالنطاق: حل| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
route_source | عنوان URL 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 | عنوان URL 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"الانتظار الأولي لمدة ثانية واحدة هو نقطة البداية لاستطلاع Job على QuickT. ثم يقدم عرض جاهز للجهاز قفصًا خلفيًا ويفسر التسليم المؤقت الموقع.
الأخطاء المتوقعة
بالنسبة لعقد الخطأ، يبدأ 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": "…"
}| بروتوكول نقل الملفات السريع | المعنى النموذجي | الإجراء |
|---|---|---|
| 400 | عنوان URL غير صحيح أو جسم أو تنسيق غير متاح. | تصحيح الطلب.حل مرة أخرى للأشكال. |
| 401 | مفتاح مفقود أو غير صالح أو منتهية الصلاحية أو ذات نطاق خاطئ. | تحقق من وثائق الاعتماد على جانب الخادم. |
| 403 | رفضت سياسة المستأجر أو المصدر الطلب. | لا تتجاوز السياسة اتصل بالدعم. |
| 404 | وظيفة غير معروفة أو منتهية الصلاحية. | قم بإنشاء وظيفة جديدة إذا كان ذلك مناسبًا. |
| 429 | طلب أو حد الوظائف النشطة تم الوصول إليه. | الشرف retry_after_seconds. |
| 503 | الطابور / السعة أو أعلى المسار غير متاح مؤقتًا. | حاول مرة أخرى مع التراجع الأسي والتذبذب. |
عقد التشغيل
يختار QuickT حدود العملاء المحمولة أثناء الموافقة بحيث تظل شبكات المبدعين وواجهة برمجة التطبيقات مستجيبة.
- استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
- تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
- استخدام الارتداد الأسي المحدود مع التشتت لـ
429,503والأخطاء القابلة لإعادة المحاولة. - لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
- احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.
بالنسبة للوصول إلى Schema ، يتحقق QuickT من التنشيط قبل الاستكشاف قبل المصادقة المخصصة. هذا العرض الجاهز للأجهزة يجعل أيضًا أشكال الطلب الموثقة واضحة.
تنشيط من خلال الدعم
وصف تجربة الهاتف المحمول وتوقع حركة المرور الخاصة بها وشبكات المبدعين التي تحتاجها. يستخدم QuickT تلك المعلومات لتعيين أذونات التحليل والانتظار قبل الكشف عن السر مرة واحدة.
طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.