https://socialvideosaver.comبناء التنزيلات مع Social Video Saver
يوفر SocialVideoSaver هذا المخطط عبر الشبكة للتخطيط التقني.تظل وثائق الاعتماد الخاصة بالإنتاج مغلقة حتى تمر حالة الاستخدام المقترحة بمراجعة دعم.
البداية السريعة
وثائق الاعتماد المنشطة بالدعم هي نقطة البداية لمضيف API على SocialVideoSaver. ثم يقدم عرض متعدد المصادر نقطة نهاية مستأجرة مخصصة ويوضح مسار استدعاء الخادم فقط.
X-API-Key: pending_activation_…SocialSaverWorkspacev1# Available only after support activation
export SVS_WORKSPACE_KEY="issued-after-review"
curl -X POST https://socialvideosaver.com/v1/resolve \
-H "X-API-Key: $SVS_WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'نظرة SocialVideoSaver متعددة المصادر مراجعات التخزين السري على جانب الخادم لسلامة Credential. إنه لا يظهر أي حزمة عملاء تضمين التالي ولا يحجب أي سجلات عامة أو مستودعات.
حل رابط
كشف المصدر هو نقطة البداية لعملية Resolve على SocialVideoSaver. ثم يقدم عرض متعدد المصادر تنسيقات من عنوان URL واحد مقدم ويشرح عدم وجود مخرجات مخترعة.
/v1/resolveالنطاق: حل| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
social_url | عنوان URL HTTPS | نعم | صفحة وسائل الإعلام العامة أو المأذون بها لتحليل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}تعرض ميزة العرض متعدد المصادر في SocialVideoSaver القيمة المعادة دون تغيير لمعرف التنسيق. كما تعرض توفر كل رابط تاليًا ولا تخفي أي تسمية جودة تم تخمينها.
إنشاء ومتابعة عمل التنزيل
يقترب SocialVideoSaver من إنشاء الوظيفة من خلال التحضير غير المتزامن ، ثم طلب HTTP قصير. يحافظ عرض المصادر المتعددة على تنفيذ العامل المحدود بشكل صريح.
/v1/jobsالنطاق: الوظائف| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
social_url | عنوان URL HTTPS | نعم | نفس المصدر المُطّبيع المقدم لحلّ. |
media_profile | سلسلة | نعم | معرف دقيق من استجابة الحل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
curl -X POST https://socialvideosaver.com/v1/jobs \
-H "X-API-Key: $SVS_WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'delivery_job.GET /v1/jobs/{delivery_job} بنفس المفتاح.| ألف - الحالة | المعنى | إجراءات العملاء |
|---|---|---|
queued | تم القبول في الطابور المحدود. | استطلاع رأي مرة أخرى مع التراجع. |
extracting | تحديث البيانات الوصفية المصدر أو الطريق. | واصلوا التصويت. |
processing | التنزيل أو إعادة المزج أو الدمج. | اعرض تقدم معالجة الخادم. |
ready | تحميل موقع متاح. | أرسل عنوان URL إلى المستخدم. |
failed | خطأ مهيكلة المحطة الطرفية. | قراءة error_code.حاول مرة أخرى فقط عندما ينصح. |
expired | أزيل الناتج المؤقت. | إنشاء وظيفة جديدة. |
curl https://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
-H "X-API-Key: $SVS_WORKSPACE_KEY"SocialVideoSaver ينظم استطلاع الوظائف حول الانتظار الأولي لمدة ثانية واحدة. نظرته متعددة المصادر تقارن الركود المقفل. يظل التسليم المؤقت الموقع هو الفحص النهائي.
الأخطاء المتوقعة
في SocialVideoSaver، يأتي غلاف واحد غير 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 | الطابور / السعة أو أعلى المسار غير متاح مؤقتًا. | حاول مرة أخرى مع التراجع الأسي والتذبذب. |
عقد التشغيل
يستعرض SocialVideoSaver الطلب المتوقع عبر الشبكة قبل تعيين حدود للتكامل المعتمد.
- استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
- تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
- استخدام الارتداد الأسي المحدود مع التشتت لـ
429,503والأخطاء القابلة لإعادة المحاولة. - لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
- احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.
التنشيط قبل الاستكشاف هو نقطة البداية للوصول إلى Schema على SocialVideoSaver. ثم يعرض عرض متعدد المصادر المصادقة المخصصة ويوضح أشكال الطلب الموثقة.
تنشيط من خلال الدعم
تلخيص المنتج عبر الشبكة، والطلب الشهري المتوقع وكل مزود اجتماعي في النطاق. SocialVideoSaver تنشيط فقط التحليل المطلوب أو قدرات العمل وتخزين هش بدلا من الرمز.
طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.