عرض مسبق فقط — يلزم التفعيل

بناء التنزيلات مع Social Video Saver

يوفر SocialVideoSaver هذا المخطط عبر الشبكة للتخطيط التقني.تظل وثائق الاعتماد الخاصة بالإنتاج مغلقة حتى تمر حالة الاستخدام المقترحة بمراجعة دعم.

SocialSaverWorkspaceJSON عبر HTTPSوظائف غير متزامنةوثائق التفويض المحددة النطاق
01

البداية السريعة

وثائق الاعتماد المنشطة بالدعم هي نقطة البداية لمضيف API على SocialVideoSaver. ثم يقدم عرض متعدد المصادر نقطة نهاية مستأجرة مخصصة ويوضح مسار استدعاء الخادم فقط.

عنوان URL المستأجرhttps://socialvideosaver.com
التوثيقX-API-Key: pending_activation_…
نبذة عن العميلSocialSaverWorkspace
إصدار APIv1
# 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. إنه لا يظهر أي حزمة عملاء تضمين التالي ولا يحجب أي سجلات عامة أو مستودعات.

02

حل رابط

كشف المصدر هو نقطة البداية لعملية 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 القيمة المعادة دون تغيير لمعرف التنسيق. كما تعرض توفر كل رابط تاليًا ولا تخفي أي تسمية جودة تم تخمينها.

03

إنشاء ومتابعة عمل التنزيل

يقترب 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"}'
1202 مقبولةحفظ delivery_job.
2حالة الاستفتاءGET /v1/jobs/{delivery_job} بنفس المفتاح.
3جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
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 ينظم استطلاع الوظائف حول الانتظار الأولي لمدة ثانية واحدة. نظرته متعددة المصادر تقارن الركود المقفل. يظل التسليم المؤقت الموقع هو الفحص النهائي.

04

الأخطاء المتوقعة

في 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الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.حاول مرة أخرى مع التراجع الأسي والتذبذب.
05

عقد التشغيل

يستعرض SocialVideoSaver الطلب المتوقع عبر الشبكة قبل تعيين حدود للتكامل المعتمد.

التنشيط قبل الاستكشاف هو نقطة البداية للوصول إلى Schema على SocialVideoSaver. ثم يعرض عرض متعدد المصادر المصادقة المخصصة ويوضح أشكال الطلب الموثقة.

الوصول الذي يستعرضه المشغل

تنشيط من خلال الدعم

تلخيص المنتج عبر الشبكة، والطلب الشهري المتوقع وكل مزود اجتماعي في النطاق. SocialVideoSaver تنشيط فقط التحليل المطلوب أو قدرات العمل وتخزين هش بدلا من الرمز.

طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.